صفحهٔ اصلی گشت‌و‌گذار راهنما
ورود
cpp
/
3DSoftwareRenderer-DFSPR
mirrorاز https://github.com/Dawoodoz/DFPSR.git
2
0
انشعاب 0
پرونده‌ها مشکلات 0 ویکی
فهرست منبع

Made a basic explanation of images.

David Piuva 5 سال پیش
والد
ecc27a7a0b
کامیت
8236efe207
4فایلهای تغییر یافته به همراه117 افزوده شده و 7 حذف شده
نمای یکپارچه نمایش آمار تفاوت ها
  1. 41 0
      Doc/Generator/Input/Images.txt
  2. 7 3
      Doc/Generator/Input/Manual.txt
  3. 60 0
      Doc/Images.html
  4. 9 4
      Doc/Manual.html

+ 41 - 0
Doc/Generator/Input/Images.txt
مشاهده فایل 

@@ -0,0 +1,41 @@
 
+<- Manual.html | Back to main page

+

+Title: Images

+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.

+---

+Title2: ImageU8

+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.

+---

+Title2: ImageU16

+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).

+---

+Title2: ImageF32

+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.

+---

+Title2: ImageRgbaU8

+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.

+---

+Title2: Aligned images

+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.

+---

+Title2: Ordered images

+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.

+---

+Title2: Loading images

+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.

+---

+Title2: Saving images

+image_save can be used to save an RGBA image to a file.

+---

+ 7 - 3
Doc/Generator/Input/Manual.txt
مشاهده فایل 

@@ -1,14 +1,18 @@
 
 Title: David Piuva's software renderer

 Title: David Piuva's software renderer

 

 

 When you just want to code in your own pace without worrying about API deprecation.

 When you just want to code in your own pace without worrying about API deprecation.

----

-Title2: Using the library

 

 

 *

 *

 <- Starting.html | Getting started

 <- Starting.html | Getting started

+---

+Title2: APIs

 

 

 *

 *

-<- Strings.html | Basic text operations

+<- Strings.html | String API

+

+*

+<- Images.html | Image API

+

 ---

 ---

 Title2: Modifying the library

 Title2: Modifying the library

+ 60 - 0
Doc/Images.html
مشاهده فایل 

@@ -0,0 +1,60 @@
 
+<!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>

+ 9 - 4
Doc/Manual.html
مشاهده فایل 

@@ -27,14 +27,19 @@ A:active { color: #00A0A0; }
 
 </P><H1> David Piuva's software renderer</H1><P>

 </P><H1> David Piuva's software renderer</H1><P>

 </P><P>

 </P><P>

 When you just want to code in your own pace without worrying about API deprecation.

 When you just want to code in your own pace without worrying about API deprecation.

-</P><IMG SRC="Images/Border.png"><P>

-</P><H2> Using the library</H2><P>

+

+</P><P>

+<IMG SRC="Images/SmallDot.png">

+<A href="Starting.html">Getting started</A></P><IMG SRC="Images/Border.png"><P>

+</P><H2> APIs</H2><P>

 </P><P>

 </P><P>

 <IMG SRC="Images/SmallDot.png">

 <IMG SRC="Images/SmallDot.png">

-<A href="Starting.html">Getting started</A>

+<A href="Strings.html">String API</A>

 </P><P>

 </P><P>

 <IMG SRC="Images/SmallDot.png">

 <IMG SRC="Images/SmallDot.png">

-<A href="Strings.html">Basic text operations</A></P><IMG SRC="Images/Border.png"><P>

+<A href="Images.html">Image API</A>

+</P><P>

+</P><IMG SRC="Images/Border.png"><P>

 </P><H2> Modifying the library</H2><P>

 </P><H2> Modifying the library</H2><P>

 </P><P>

 </P><P>

 <IMG SRC="Images/SmallDot.png">

 <IMG SRC="Images/SmallDot.png">