ImgDoc_CreateWithPicture

Create an image document instance referencing image data provided in a 4D picture.
ImgDoc_CreateWithPicture(pictPtr{; options}) ➔ imgDocRef
pictPtr Pointer A pointer to a picture.
options Object Options.
imgDocRef Text The reference to the created image document instance.

Create an image document instance referencing image data provided in a 4D picture. The image document reference is returned in imgDocRef.

If the method call fails for some reason, an empty string is returned and the Q2Pix error info is set accordingly.

Parameter pictPtr is a pointer to a 4D picture.

A 4D picture may contain multiple representations of the same image. This method finds the first representation in a supported format with the help of the PictUtil_GetImageFormats plug-in method, extracts the representation’s image data with a call to the PictUtil_GetImageData plug-in method, and finally passes the image data to ImgDoc_CreateWithBLOB.

For more information, see the ImgDoc_CreateWithBLOB component method.