vips.go 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672
  1. package main
  2. /*
  3. #cgo pkg-config: vips
  4. #cgo LDFLAGS: -s -w
  5. #cgo CFLAGS: -O3
  6. #include "vips.h"
  7. */
  8. import "C"
  9. import (
  10. "context"
  11. "errors"
  12. "math"
  13. "os"
  14. "runtime"
  15. "time"
  16. "unsafe"
  17. )
  18. type vipsImage struct {
  19. VipsImage *C.VipsImage
  20. }
  21. var (
  22. vipsSupportSmartcrop bool
  23. vipsTypeSupportLoad = make(map[imageType]bool)
  24. vipsTypeSupportSave = make(map[imageType]bool)
  25. watermark *vipsImage
  26. errSmartCropNotSupported = errors.New("Smart crop is not supported by used version of libvips")
  27. )
  28. var vipsConf struct {
  29. JpegProgressive C.int
  30. PngInterlaced C.int
  31. PngQuantize C.int
  32. PngQuantizationColors C.int
  33. WatermarkOpacity C.double
  34. }
  35. const (
  36. vipsAngleD0 = C.VIPS_ANGLE_D0
  37. vipsAngleD90 = C.VIPS_ANGLE_D90
  38. vipsAngleD180 = C.VIPS_ANGLE_D180
  39. vipsAngleD270 = C.VIPS_ANGLE_D270
  40. )
  41. func initVips() {
  42. runtime.LockOSThread()
  43. defer runtime.UnlockOSThread()
  44. if err := C.vips_initialize(); err != 0 {
  45. C.vips_shutdown()
  46. logFatal("unable to start vips!")
  47. }
  48. // Disable libvips cache. Since processing pipeline is fine tuned, we won't get much profit from it.
  49. // Enabled cache can cause SIGSEGV on Musl-based systems like Alpine.
  50. C.vips_cache_set_max_mem(0)
  51. C.vips_cache_set_max(0)
  52. C.vips_concurrency_set(1)
  53. if len(os.Getenv("IMGPROXY_VIPS_LEAK_CHECK")) > 0 {
  54. C.vips_leak_set(C.gboolean(1))
  55. }
  56. if len(os.Getenv("IMGPROXY_VIPS_CACHE_TRACE")) > 0 {
  57. C.vips_cache_set_trace(C.gboolean(1))
  58. }
  59. vipsSupportSmartcrop = C.vips_support_smartcrop() == 1
  60. if int(C.vips_type_find_load_go(C.int(imageTypeJPEG))) != 0 {
  61. vipsTypeSupportLoad[imageTypeJPEG] = true
  62. }
  63. if int(C.vips_type_find_load_go(C.int(imageTypePNG))) != 0 {
  64. vipsTypeSupportLoad[imageTypePNG] = true
  65. }
  66. if int(C.vips_type_find_load_go(C.int(imageTypeWEBP))) != 0 {
  67. vipsTypeSupportLoad[imageTypeWEBP] = true
  68. }
  69. if int(C.vips_type_find_load_go(C.int(imageTypeGIF))) != 0 {
  70. vipsTypeSupportLoad[imageTypeGIF] = true
  71. }
  72. if int(C.vips_type_find_load_go(C.int(imageTypeSVG))) != 0 {
  73. vipsTypeSupportLoad[imageTypeSVG] = true
  74. }
  75. if int(C.vips_type_find_load_go(C.int(imageTypeHEIC))) != 0 {
  76. vipsTypeSupportLoad[imageTypeHEIC] = true
  77. }
  78. // we load ICO with github.com/mat/besticon/ico and send decoded data to vips
  79. vipsTypeSupportLoad[imageTypeICO] = true
  80. if int(C.vips_type_find_save_go(C.int(imageTypeJPEG))) != 0 {
  81. vipsTypeSupportSave[imageTypeJPEG] = true
  82. }
  83. if int(C.vips_type_find_save_go(C.int(imageTypePNG))) != 0 {
  84. vipsTypeSupportSave[imageTypePNG] = true
  85. }
  86. if int(C.vips_type_find_save_go(C.int(imageTypeWEBP))) != 0 {
  87. vipsTypeSupportSave[imageTypeWEBP] = true
  88. }
  89. if int(C.vips_type_find_save_go(C.int(imageTypeGIF))) != 0 {
  90. vipsTypeSupportSave[imageTypeGIF] = true
  91. }
  92. if int(C.vips_type_find_save_go(C.int(imageTypeICO))) != 0 {
  93. vipsTypeSupportSave[imageTypeICO] = true
  94. }
  95. if int(C.vips_type_find_save_go(C.int(imageTypeHEIC))) != 0 {
  96. vipsTypeSupportSave[imageTypeHEIC] = true
  97. }
  98. if conf.JpegProgressive {
  99. vipsConf.JpegProgressive = C.int(1)
  100. }
  101. if conf.PngInterlaced {
  102. vipsConf.PngInterlaced = C.int(1)
  103. }
  104. if conf.PngQuantize {
  105. vipsConf.PngQuantize = C.int(1)
  106. }
  107. vipsConf.PngQuantizationColors = C.int(conf.PngQuantizationColors)
  108. vipsConf.WatermarkOpacity = C.double(conf.WatermarkOpacity)
  109. if err := vipsPrepareWatermark(); err != nil {
  110. logFatal(err.Error())
  111. }
  112. vipsCollectMetrics()
  113. }
  114. func shutdownVips() {
  115. if watermark != nil {
  116. watermark.Clear()
  117. }
  118. C.vips_shutdown()
  119. }
  120. func vipsCollectMetrics() {
  121. if prometheusEnabled {
  122. go func() {
  123. for range time.Tick(5 * time.Second) {
  124. prometheusVipsMemory.Set(float64(C.vips_tracked_get_mem()))
  125. prometheusVipsMaxMemory.Set(float64(C.vips_tracked_get_mem_highwater()))
  126. prometheusVipsAllocs.Set(float64(C.vips_tracked_get_allocs()))
  127. }
  128. }()
  129. }
  130. }
  131. func vipsCleanup() {
  132. C.vips_cleanup()
  133. }
  134. func vipsError() error {
  135. return newUnexpectedError(C.GoString(C.vips_error_buffer()), 1)
  136. }
  137. func vipsPrepareWatermark() error {
  138. data, imgtype, cancel, err := watermarkData()
  139. defer cancel()
  140. if err != nil {
  141. return err
  142. }
  143. if data == nil {
  144. return nil
  145. }
  146. watermark = new(vipsImage)
  147. if err = watermark.Load(data, imgtype, 1, 1.0, 1); err != nil {
  148. return err
  149. }
  150. var tmp *C.VipsImage
  151. if C.vips_apply_opacity(watermark.VipsImage, &tmp, C.double(conf.WatermarkOpacity)) != 0 {
  152. return vipsError()
  153. }
  154. C.swap_and_clear(&watermark.VipsImage, tmp)
  155. if err = watermark.CopyMemory(); err != nil {
  156. return err
  157. }
  158. return nil
  159. }
  160. func vipsResizeWatermark(width, height int) (wm *vipsImage, err error) {
  161. wmW := float64(watermark.VipsImage.Xsize)
  162. wmH := float64(watermark.VipsImage.Ysize)
  163. wr := float64(width) / wmW
  164. hr := float64(height) / wmH
  165. scale := math.Min(wr, hr)
  166. if wmW*scale < 1 {
  167. scale = 1 / wmW
  168. }
  169. if wmH*scale < 1 {
  170. scale = 1 / wmH
  171. }
  172. wm = new(vipsImage)
  173. if C.vips_resize_with_premultiply(watermark.VipsImage, &wm.VipsImage, C.double(scale)) != 0 {
  174. err = vipsError()
  175. }
  176. return
  177. }
  178. func (img *vipsImage) Width() int {
  179. return int(img.VipsImage.Xsize)
  180. }
  181. func (img *vipsImage) Height() int {
  182. return int(img.VipsImage.Ysize)
  183. }
  184. func (img *vipsImage) Load(data []byte, imgtype imageType, shrink int, scale float64, pages int) error {
  185. var tmp *C.VipsImage
  186. err := C.int(0)
  187. switch imgtype {
  188. case imageTypeJPEG:
  189. err = C.vips_jpegload_go(unsafe.Pointer(&data[0]), C.size_t(len(data)), C.int(shrink), &tmp)
  190. case imageTypePNG:
  191. err = C.vips_pngload_go(unsafe.Pointer(&data[0]), C.size_t(len(data)), &tmp)
  192. case imageTypeWEBP:
  193. err = C.vips_webpload_go(unsafe.Pointer(&data[0]), C.size_t(len(data)), C.double(scale), C.int(pages), &tmp)
  194. case imageTypeGIF:
  195. err = C.vips_gifload_go(unsafe.Pointer(&data[0]), C.size_t(len(data)), C.int(pages), &tmp)
  196. case imageTypeSVG:
  197. err = C.vips_svgload_go(unsafe.Pointer(&data[0]), C.size_t(len(data)), C.double(scale), &tmp)
  198. case imageTypeICO:
  199. rawData, width, height, icoErr := icoData(data)
  200. if icoErr != nil {
  201. return icoErr
  202. }
  203. tmp = C.vips_image_new_from_memory_copy(unsafe.Pointer(&rawData[0]), C.size_t(width*height*4), C.int(width), C.int(height), 4, C.VIPS_FORMAT_UCHAR)
  204. case imageTypeHEIC:
  205. err = C.vips_heifload_go(unsafe.Pointer(&data[0]), C.size_t(len(data)), &tmp)
  206. }
  207. if err != 0 {
  208. return vipsError()
  209. }
  210. C.swap_and_clear(&img.VipsImage, tmp)
  211. return nil
  212. }
  213. func (img *vipsImage) Save(imgtype imageType, quality int) ([]byte, context.CancelFunc, error) {
  214. var ptr unsafe.Pointer
  215. cancel := func() {
  216. C.g_free_go(&ptr)
  217. }
  218. err := C.int(0)
  219. imgsize := C.size_t(0)
  220. switch imgtype {
  221. case imageTypeJPEG:
  222. err = C.vips_jpegsave_go(img.VipsImage, &ptr, &imgsize, C.int(quality), vipsConf.JpegProgressive)
  223. case imageTypePNG:
  224. err = C.vips_pngsave_go(img.VipsImage, &ptr, &imgsize, vipsConf.PngInterlaced, vipsConf.PngQuantize, vipsConf.PngQuantizationColors)
  225. case imageTypeWEBP:
  226. err = C.vips_webpsave_go(img.VipsImage, &ptr, &imgsize, C.int(quality))
  227. case imageTypeGIF:
  228. err = C.vips_gifsave_go(img.VipsImage, &ptr, &imgsize)
  229. case imageTypeICO:
  230. err = C.vips_icosave_go(img.VipsImage, &ptr, &imgsize)
  231. case imageTypeHEIC:
  232. err = C.vips_heifsave_go(img.VipsImage, &ptr, &imgsize, C.int(quality))
  233. }
  234. if err != 0 {
  235. C.g_free_go(&ptr)
  236. return nil, cancel, vipsError()
  237. }
  238. const maxBufSize = ^uint32(0)
  239. b := (*[maxBufSize]byte)(ptr)[:int(imgsize):int(imgsize)]
  240. return b, cancel, nil
  241. }
  242. func (img *vipsImage) Clear() {
  243. if img.VipsImage != nil {
  244. C.clear_image(&img.VipsImage)
  245. }
  246. }
  247. func (img *vipsImage) Arrayjoin(in []*vipsImage) error {
  248. var tmp *C.VipsImage
  249. arr := make([]*C.VipsImage, len(in))
  250. for i, im := range in {
  251. arr[i] = im.VipsImage
  252. }
  253. if C.vips_arrayjoin_go(&arr[0], &tmp, C.int(len(arr))) != 0 {
  254. return vipsError()
  255. }
  256. C.swap_and_clear(&img.VipsImage, tmp)
  257. return nil
  258. }
  259. func vipsSupportAnimation(imgtype imageType) bool {
  260. return imgtype == imageTypeGIF ||
  261. (imgtype == imageTypeWEBP && C.vips_support_webp_animation() != 0)
  262. }
  263. func (img *vipsImage) IsAnimated() bool {
  264. return C.vips_is_animated(img.VipsImage) > 0
  265. }
  266. func (img *vipsImage) HasAlpha() bool {
  267. return C.vips_image_hasalpha_go(img.VipsImage) > 0
  268. }
  269. func (img *vipsImage) GetInt(name string) (int, error) {
  270. var i C.int
  271. if C.vips_image_get_int(img.VipsImage, cachedCString(name), &i) != 0 {
  272. return 0, vipsError()
  273. }
  274. return int(i), nil
  275. }
  276. func (img *vipsImage) SetInt(name string, value int) {
  277. C.vips_image_set_int(img.VipsImage, cachedCString(name), C.int(value))
  278. }
  279. func (img *vipsImage) CastUchar() error {
  280. var tmp *C.VipsImage
  281. if C.vips_image_get_format(img.VipsImage) != C.VIPS_FORMAT_UCHAR {
  282. if C.vips_cast_go(img.VipsImage, &tmp, C.VIPS_FORMAT_UCHAR) != 0 {
  283. return vipsError()
  284. }
  285. C.swap_and_clear(&img.VipsImage, tmp)
  286. }
  287. return nil
  288. }
  289. func (img *vipsImage) Rad2Float() error {
  290. var tmp *C.VipsImage
  291. if C.vips_image_get_coding(img.VipsImage) == C.VIPS_CODING_RAD {
  292. if C.vips_rad2float_go(img.VipsImage, &tmp) != 0 {
  293. return vipsError()
  294. }
  295. C.swap_and_clear(&img.VipsImage, tmp)
  296. }
  297. return nil
  298. }
  299. func (img *vipsImage) Resize(scale float64, hasAlpa bool) error {
  300. var tmp *C.VipsImage
  301. if hasAlpa {
  302. if C.vips_resize_with_premultiply(img.VipsImage, &tmp, C.double(scale)) != 0 {
  303. return vipsError()
  304. }
  305. } else {
  306. if C.vips_resize_go(img.VipsImage, &tmp, C.double(scale)) != 0 {
  307. return vipsError()
  308. }
  309. }
  310. C.swap_and_clear(&img.VipsImage, tmp)
  311. return nil
  312. }
  313. func (img *vipsImage) Orientation() C.int {
  314. return C.vips_get_exif_orientation(img.VipsImage)
  315. }
  316. func (img *vipsImage) Rotate(angle int) error {
  317. var tmp *C.VipsImage
  318. if C.vips_rot_go(img.VipsImage, &tmp, C.VipsAngle(angle)) != 0 {
  319. return vipsError()
  320. }
  321. C.swap_and_clear(&img.VipsImage, tmp)
  322. return nil
  323. }
  324. func (img *vipsImage) Flip() error {
  325. var tmp *C.VipsImage
  326. if C.vips_flip_horizontal_go(img.VipsImage, &tmp) != 0 {
  327. return vipsError()
  328. }
  329. C.swap_and_clear(&img.VipsImage, tmp)
  330. return nil
  331. }
  332. func (img *vipsImage) Crop(left, top, width, height int) error {
  333. var tmp *C.VipsImage
  334. if C.vips_extract_area_go(img.VipsImage, &tmp, C.int(left), C.int(top), C.int(width), C.int(height)) != 0 {
  335. return vipsError()
  336. }
  337. C.swap_and_clear(&img.VipsImage, tmp)
  338. return nil
  339. }
  340. func (img *vipsImage) Extract(out *vipsImage, left, top, width, height int) error {
  341. if C.vips_extract_area_go(img.VipsImage, &out.VipsImage, C.int(left), C.int(top), C.int(width), C.int(height)) != 0 {
  342. return vipsError()
  343. }
  344. return nil
  345. }
  346. func (img *vipsImage) SmartCrop(width, height int) error {
  347. var tmp *C.VipsImage
  348. if C.vips_smartcrop_go(img.VipsImage, &tmp, C.int(width), C.int(height)) != 0 {
  349. return vipsError()
  350. }
  351. C.swap_and_clear(&img.VipsImage, tmp)
  352. return nil
  353. }
  354. func (img *vipsImage) EnsureAlpha() error {
  355. var tmp *C.VipsImage
  356. if C.vips_ensure_alpha(img.VipsImage, &tmp) != 0 {
  357. return vipsError()
  358. }
  359. C.swap_and_clear(&img.VipsImage, tmp)
  360. return nil
  361. }
  362. func (img *vipsImage) Flatten(bg rgbColor) error {
  363. var tmp *C.VipsImage
  364. if C.vips_flatten_go(img.VipsImage, &tmp, C.double(bg.R), C.double(bg.G), C.double(bg.B)) != 0 {
  365. return vipsError()
  366. }
  367. C.swap_and_clear(&img.VipsImage, tmp)
  368. return nil
  369. }
  370. func (img *vipsImage) Blur(sigma float32) error {
  371. var tmp *C.VipsImage
  372. if C.vips_gaussblur_go(img.VipsImage, &tmp, C.double(sigma)) != 0 {
  373. return vipsError()
  374. }
  375. C.swap_and_clear(&img.VipsImage, tmp)
  376. return nil
  377. }
  378. func (img *vipsImage) Sharpen(sigma float32) error {
  379. var tmp *C.VipsImage
  380. if C.vips_sharpen_go(img.VipsImage, &tmp, C.double(sigma)) != 0 {
  381. return vipsError()
  382. }
  383. C.swap_and_clear(&img.VipsImage, tmp)
  384. return nil
  385. }
  386. func (img *vipsImage) ImportColourProfile(evenSRGB bool) error {
  387. var tmp *C.VipsImage
  388. if img.VipsImage.Coding != C.VIPS_CODING_NONE {
  389. return nil
  390. }
  391. if img.VipsImage.BandFmt != C.VIPS_FORMAT_UCHAR && img.VipsImage.BandFmt != C.VIPS_FORMAT_USHORT {
  392. return nil
  393. }
  394. profile := (*C.char)(nil)
  395. if img.VipsImage.Type == C.VIPS_INTERPRETATION_sRGB {
  396. // No embedded profile for sRGB, ignore
  397. if C.vips_has_embedded_icc(img.VipsImage) == 0 {
  398. return nil
  399. }
  400. // Don't import sRGB IEC61966 2.1 unless evenSRGB
  401. if !evenSRGB && C.vips_icc_is_srgb_iec61966(img.VipsImage) != 0 {
  402. return nil
  403. }
  404. } else if img.VipsImage.Type == C.VIPS_INTERPRETATION_CMYK && C.vips_has_embedded_icc(img.VipsImage) == 0 {
  405. if C.vips_support_builtin_icc() != 0 {
  406. profile = cachedCString("cmyk")
  407. } else {
  408. p, err := cmykProfilePath()
  409. if err != nil {
  410. return err
  411. }
  412. profile = cachedCString(p)
  413. }
  414. }
  415. if C.vips_icc_import_go(img.VipsImage, &tmp, profile) == 0 {
  416. C.swap_and_clear(&img.VipsImage, tmp)
  417. } else {
  418. logWarning("Can't import ICC profile: %s", vipsError())
  419. }
  420. return nil
  421. }
  422. func (img *vipsImage) LinearColourspace() error {
  423. return img.Colorspace(C.VIPS_INTERPRETATION_scRGB)
  424. }
  425. func (img *vipsImage) RgbColourspace() error {
  426. return img.Colorspace(C.VIPS_INTERPRETATION_sRGB)
  427. }
  428. func (img *vipsImage) Colorspace(colorspace C.VipsInterpretation) error {
  429. if C.vips_image_guess_interpretation(img.VipsImage) != colorspace {
  430. var tmp *C.VipsImage
  431. if C.vips_colourspace_go(img.VipsImage, &tmp, colorspace) != 0 {
  432. return vipsError()
  433. }
  434. C.swap_and_clear(&img.VipsImage, tmp)
  435. }
  436. return nil
  437. }
  438. func (img *vipsImage) CopyMemory() error {
  439. var tmp *C.VipsImage
  440. if tmp = C.vips_image_copy_memory(img.VipsImage); tmp == nil {
  441. return vipsError()
  442. }
  443. C.swap_and_clear(&img.VipsImage, tmp)
  444. return nil
  445. }
  446. func (img *vipsImage) Replicate(width, height int) error {
  447. var tmp *C.VipsImage
  448. if C.vips_replicate_go(img.VipsImage, &tmp, C.int(width), C.int(height)) != 0 {
  449. return vipsError()
  450. }
  451. C.swap_and_clear(&img.VipsImage, tmp)
  452. return nil
  453. }
  454. func (img *vipsImage) Embed(gravity gravityType, width, height int, offX, offY int) error {
  455. wmWidth := img.Width()
  456. wmHeight := img.Height()
  457. left := (width-wmWidth+1)/2 + offX
  458. top := (height-wmHeight+1)/2 + offY
  459. if gravity == gravityNorth || gravity == gravityNorthEast || gravity == gravityNorthWest {
  460. top = offY
  461. }
  462. if gravity == gravityEast || gravity == gravityNorthEast || gravity == gravitySouthEast {
  463. left = width - wmWidth - offX
  464. }
  465. if gravity == gravitySouth || gravity == gravitySouthEast || gravity == gravitySouthWest {
  466. top = height - wmHeight - offY
  467. }
  468. if gravity == gravityWest || gravity == gravityNorthWest || gravity == gravitySouthWest {
  469. left = offX
  470. }
  471. if left > width {
  472. left = width - wmWidth
  473. } else if left < -wmWidth {
  474. left = 0
  475. }
  476. if top > height {
  477. top = height - wmHeight
  478. } else if top < -wmHeight {
  479. top = 0
  480. }
  481. var tmp *C.VipsImage
  482. if C.vips_embed_go(img.VipsImage, &tmp, C.int(left), C.int(top), C.int(width), C.int(height)) != 0 {
  483. return vipsError()
  484. }
  485. C.swap_and_clear(&img.VipsImage, tmp)
  486. return nil
  487. }
  488. func (img *vipsImage) ApplyWatermark(opts *watermarkOptions) error {
  489. if watermark == nil {
  490. return nil
  491. }
  492. var (
  493. wm *vipsImage
  494. tmp *C.VipsImage
  495. )
  496. defer wm.Clear()
  497. var err error
  498. imgW := img.Width()
  499. imgH := img.Height()
  500. if opts.Scale == 0 {
  501. wm = new(vipsImage)
  502. if C.vips_copy_go(watermark.VipsImage, &wm.VipsImage) != 0 {
  503. return vipsError()
  504. }
  505. } else {
  506. wmW := maxInt(int(float64(imgW)*opts.Scale), 1)
  507. wmH := maxInt(int(float64(imgH)*opts.Scale), 1)
  508. if wm, err = vipsResizeWatermark(wmW, wmH); err != nil {
  509. return err
  510. }
  511. }
  512. if opts.Replicate {
  513. if err = wm.Replicate(imgW, imgH); err != nil {
  514. return err
  515. }
  516. } else {
  517. if err = wm.Embed(opts.Gravity, imgW, imgH, opts.OffsetX, opts.OffsetY); err != nil {
  518. return err
  519. }
  520. }
  521. if C.vips_apply_watermark(img.VipsImage, wm.VipsImage, &tmp, C.double(opts.Opacity)) != 0 {
  522. return vipsError()
  523. }
  524. C.swap_and_clear(&img.VipsImage, tmp)
  525. return nil
  526. }