cpp
/
3DSoftwareRenderer-DFSPR
mirror of https://github.com/Dawoodoz/DFPSR.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
							<!DOCTYPE html> <HTML lang=en> <HEAD> <STYLE>
body { background-color: #EEFFEE; font-size: 16px; font-family: Arial;
       color: #000000; margin: 0px;
       padding-left: 0px; padding-right: 0px;
       padding-top: 0px; padding-bottom: 0px; }
H1 { padding-left: 10px; padding-top: 10px; padding-bottom: 10px; font-size: 26px; }
H2 { padding-left: 10px; padding-top: 10px;  font-size: 20px; }
blockquote {
  color: #FFFFFF; background: #000000;
  font-size: 20px; font-family: monospace;
  padding-left: 5px; padding-right: 5px;
  padding-top: 5px; padding-bottom: 5px;
}
P { padding-left: 10px; }
IMG { padding-left: 0px; padding-right: 0px;
       padding-top: 0px; padding-bottom: 0px; }

A { font-size: 18px; font-family: Arial; color: #0000A0; text-decoration: none; }
A:hover { color: #000070; background: #AAffAA; }
A:active { color: #00A0A0; }
.normal { font-size: 18px; color: #00A0A0; }
.sub { font-size: 18px; color: #ffffdf; }

</STYLE> </HEAD> <BODY>
<IMG SRC="Images/Title.png" ALT="Images/Title.png">
<P>
<A href="Manual.html">Back to main page</A>
</P><P>
</P><H1> Images</H1><P>All image types are passed using reference counted handles so that they are automatically cleaned up when the last handle is freed.
This does add a little allocation overhead compared to having them as value types, but generating mip-map pyramids require a unique identity to prevent aliasing.
If a method doesn't allow the image handle to be null, it will give you a run-time warning about it in debug mode.
You won't have to worry about if the image is a value, reference, raw pointer, shared pointer or unique, because it's always the same type of handle.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> ImageU8</H2><P>The most basic image format used for 8-bit gray-scale images using 0 for black and 255 for white.
Can be displayed by drawing it using draw_copy onto a color image for automatic conversion.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> ImageU16</H2><P>If 8-bit precision is not enough but you still want the determinism of using integers, there's also a 16-bit monochrome image.
Just like 8-bit images, the visible range is 0 to 255 when converting automatically, but the 16-bit image has a higher range up to 65535 (2¹⁶ - 1).
</P><IMG SRC="Images/Border.png"><P>
</P><H2> ImageF32</H2><P>32-bit floating-point images offer more flexibility for advanced image filtering, but does not have the same determinism as integer formats.
Avoid exact equality comparisons using floating-point numbers, because it's always an approximation and the rounding method may differ between CPU models.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> ImageRgbaU8</H2><P>A 32-bit color image format using 4 channels with 8 bits in each. The alpha channel can be used to represent opacity or any other information needed.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> Aligned images</H2><P>Then there's the aligned image types AlignedImageU8, AlignedImageU16, AlignedImageF32 and AlignedImageRgbaU8.
Aligned images are created from the constructors by default because new images are always aligned for 128-bit SIMD vectorization.
Non-aligned images are created as sub-images pointing to existing pixel buffers without cloning.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> Ordered images</H2><P>The ordered image type OrderedImageRgbaU8 is aligned just like AlignedImageU8 but also ensures that
the pack order is RGBA on every platform, which makes it easy to manuipulate using pointers.
AlignedImageRgbaU8 can however be dynamically set to different internal pack orders using the
constructor image_create_RgbaU8_native, which is used by the window's canvas.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> Loading images</H2><P>image_load_RgbaU8 can be used to load an RGBA image from a file.
If you only need one channel, then use image_get_red on the result to extract the first channel from a gray-scale image.
</P><IMG SRC="Images/Border.png"><P>
</P><H2> Saving images</H2><P>image_save can be used to save an RGBA image to a file.
</P><IMG SRC="Images/Border.png"><P>
</P>
</BODY> </HTML>