Documentation Talk:Reference Section 1

Partial Output Options

Start_Column=n	Set first column to n pixels
Start_Column=0.n	Set first column to n percent of width
+SC0.n	Same as Start_Column
Start_Row=n	Set first row to n pixels
Start_Row=0.n	Set first row to n percent of height
+Sn	Same as Start_Row=n
+SR0.n or +S0.n	Same as Start_Row=0.n
End_Column=n	Set last column to n pixels
End_Column=0.n	Set last column to n percent of width
+EC0.n	Same as End_Column
End_Row=n	Set last row to n pixels
End_Row=0.n	Set last row to n percent of height
+En	Same as End_Row=n
+ER0.n or +E0.n	Same as End_Row=0.n

When doing test rendering it is often convenient to define a small, rectangular sub-section of the whole screen so you can quickly check out one area of the image. The Start_Row, End_Row, Start_Column and End_Column options allow you to define the subset area to be rendered. The default values are the full size of the image from (1,1) which is the upper left to (w,h) on the lower right where w and h are the Width=n and Height=n values you have set.

Note: if the number specified is greater than 1 then it is interpreted as an absolute row or column number in pixels. If it is a decimal value between 0.0 and 1.0 then it is interpreted as a percent of the total width or height of the image.

For example: Start_Row=0.75 and Start_Column=0.75 starts on a row 75% down from the top at a column 75% from the left. Thus it renders only the lower-right 25% of the image regardless of the specified width and height.

The +SR, +ER, +SC and +EC switches work in the same way as the corresponding INI-style settings for both absolute settings or percentages. Early versions of POV-Ray allowed only start and end rows to be specified with +Sn and +En so they are still supported in addition to +SR and +ER.

When rendering a subset of *columns* (+sc/+ec) POV-Ray generates a full width image and fills the not rendered columns with black pixels. This should not be a problem for any image reading program no matter what file format is used.

When rendering a subset of *rows* (+sr/+er) POV-Ray writes the full height into the image file header and only writes those lines into the image that are rendered. This can cause problems with image reading programs that are not checking the file while reading and just read over the end.

If POV-Ray wrote the actual height of the partial image into the image header there would be no way to continue the trace in a later run.

• Merged correction (writed->writes) back into main document. As well as missing caps on 1st words of last two paragraphs. BTW: It's not necessary to copy the ENTIRE page just the affected section(s) please. --jholsenback 03:30, 28 May 2010 (UTC)