关于

The MAXON API provides several interfaces to handle image data. All these interfaces are based on maxon::ImageBaseInterface :

maxon::ImageBaseInterface : Base interface of all image interfaces that handles basic image properties.
maxon::ImageTextureInterface : A texture object with layers. Used to load and save image files.
maxon::ImageInterface : Represents a single image within a maxon::ImageTextureInterface .
maxon::ImageLayerInterface : Represents a single layer within a maxon::ImageInterface .

注意: Typically these image classes represent uncompressed image data. But it is also possible that an image could store compressed or non-RGB data.; A maxon::ImageRef can be obtained from a BaseBitmap using BaseBitmap::GetImageRef() 。见 BaseBitmap Manual .

// This example creates a new image and fills it with random RBG data. // The image is then stored in a PNG file.

// create ImageRef implementation of ImageInterface const maxon::ImageRef image = maxon::ImageClasses::IMAGE().Create() iferr_return ;

// init image const maxon::PixelFormat rgbFormat = maxon::PixelFormats::RGB::U8(); const auto storageType = maxon::ImagePixelStorageClasses::Normal(); image.Init(width, height, storageType, rgbFormat) iferr_return ;

// get handler to fill image const maxon::ChannelOffsets & offset = rgbFormat.GetChannelOffsets(); const maxon::SETPIXELHANDLERFLAGS flags = maxon::SETPIXELHANDLERFLAGS::NONE ; const maxon::SetPixelHandlerStruct destHandler = image.SetPixelHandler(rgbFormat, offset, maxon::ColorProfile(), flags) iferr_return ;

// random number generator for random colors maxon::LinearCongruentialRandom<maxon::Float32> random; random. Init (0);

// array to store RGB data of a single pixel maxon::BaseArray<maxon::UChar> pixelArray; pixelArray. Resize (3) iferr_return ;

const maxon::BITS bitsPerPixel = rgbFormat.GetBitsPerPixel(); // size per pixel

// for each pixel generate a random color and store it in the image for ( maxon::Int y = 0; y < height; ++y) { for ( maxon::Int x = 0; x < width; ++x) { auto GetRandomValue = [&random]() -> maxon::UChar { // get random value from 0 to 255 // use 255.9 to make sure all values have equal probability const maxon::Float randomValue = random. Get01 () * 255.9; return maxon::SafeConvert<maxon::UChar>(randomValue); };

// create random RGB data pixelArray[0] = GetRandomValue(); pixelArray[1] = GetRandomValue(); pixelArray[2] = GetRandomValue();

// prepare data maxon::UChar * data = pixelArray. GetFirst (); const maxon::PixelMutableBuffer buffer(data, bitsPerPixel); // pixel data

// set pixel data const maxon::ImagePos pos { x, y, 1 }; // pixel position and count destHandler. SetPixel (pos, buffer, maxon::SETPIXELFLAGS::NONE ) iferr_return ; } }

// save image data to file

// create MediaOutputUrlRef from maxon::ImageSaverClasses::Png published object. const maxon::MediaOutputUrlRef png = maxon::ImageSaverClasses::Png().Create() iferr_return ; // prepare MediaSession maxon::MediaSessionRef session;

// prepare ImageTextureRef const maxon::ImageTextureRef textureRef = maxon::ImageTextureClasses::TEXTURE().Create() iferr_return ; // add the prepared ImageRef as a child textureRef.AddChildren( maxon::IMAGEHIERARCHY::IMAGE , image, maxon::ImageBaseRef()) iferr_return ; // save to target URL as PNG using the given MediaSession textureRef.Save(target, png, maxon::MEDIASESSIONFLAGS::NONE , &session) iferr_return ;

// use MediaSession save the image to a file session.Convert( maxon::TimeValue (), maxon::MEDIASESSIONFLAGS::NONE ) iferr_return ; session.Close() iferr_return ;

内容表

关于

ImageBaseInterface

ImageTextureInterface

ImageInterface

ImageLayerInterface

Utility

延伸阅读