Difference between revisions of "User:Wfpokorny"

From POV-Wiki
Jump to navigation Jump to search
m (Typo in previous edit...)
(Some initial documentation for my active git branches.)
Line 1: Line 1:
  
[[User:Wfpokorny/DensityFile| Density File Pattern - proposed documentation updates.]]
 
  
 +
=The Playpen=
  
<p></p>
+
<p>A bit of documentation for items currently in my POV-Ray playpen.</p>
* Experimenting... Please ignore anything here and below for the moment.     
+
 
<p></p>
+
==Git Branches on github==
 +
 
 +
<p>I'm maintaining my POV-Ray patches as un-merged github branches to make it easier for me to keep them current
 +
with the POV-Ray master branch. In my own space I occasionally create my own version of POV-Ray which includes
 +
just the branches/patches of mine and others that I want.</p>
 +
 
 +
<p>Pointers to my active branches follow with the thought some might be generally useful to others in rolling
 +
their own versions of POV-Ray.</p>
 +
 
 +
===Tune Blob Accuracy===
 +
<p>This just tweaks an internal value in blob.cpp that in my testing of blobs over the past year I've found works better.
 +
I will eventually package up all my blob test cases and open a github issue/pull request, but not there today...</p>
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git tune/blob_accuracy</code></p>
 +
 
 +
===Density File Pattern Updates===
 +
<p>A three pronged effort to improve .df3 density file pattern support.<p>
 +
<ol>
 +
<li>Improved user documentation.
 +
<li>Additional array coupled df3 creation and read support. Write support exists. 
 +
<li>Fixes and extensions for the density file pattern.
 +
</ol>
 +
 
 +
<p>See: [[User:Wfpokorny/DensityFile| Density File Pattern - proposed documentation updates.]]</p>
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git feature/newDensityPatternInterpolations</code></p>
 +
 
 +
<p>Pull request #79 on github.</p>
 +
 
 +
===Allowing image_map use in density block===
 +
<p>A more targeted feature addition to the density feature requested by developers. I use the pigment_map
 +
branch, which includes this image_map support.</p> 
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git feature/image_map_wDensity</code></p>
 +
 
 +
<p>Pull request #82 on github.</p>
 +
 
 +
===Addition black_hole warp type(s)===
 +
<p>The black_hole warp in master today has just type 0 support so the type is not really documented though the parser picks it up. Further the default sucking black_hole is clamped in movement and it sometimes reaches outside the black_hole range making for interesting effects I've used, but certainly confusing results for any novice. This patch adds a type 1 version of the black_hole warp which duplicates exactly the pushing/inverted form of type 0, but for the sucking form it implements a form more like what folks would expect. The default with this patch is still type 0 so type 1 needs to be specified to use the new type.</p> 
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git feature/newBlack_holeTypes</code></p>
 +
 
 +
<p>Pull request #86 on github.</p>
 +
 
 +
===Non-portable 32 bit DF3 write capability===
 +
<p>Pull request for this rejected as not portable - and I admit I don't understand the particulars. The feature works for me on linux though and I find it useful so I maintain it for my use.</p> 
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git feature/nonPortable32bitDF3Write</code></p>
 +
 +
===Both image_map and pigment_map support in density block===
 +
<p>Lets one use both image_map and pigment_map in density{} as a way to quickly get full color density/media.</p> 
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git feature/pigment_map_wDensity</code></p>
 +
 
 +
===Unix file and console column wrap control by environment variable===
 +
<p>Enabling control of the wrapping via environment variables of
 +
POVRAY_CONSOLE_COLUMNS for the console and POVRAY_TEXTSTREAM_COLUMNS
 +
for files and console.</p> 
 +
 
 +
<p>Note. There is an active pull req #117 approaching this issue in another way.</p>
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git feature/unixConsoleFileColumnWrapControl</code></p>
 +
    
 +
===Fix. Rejected parser check for subsurface crash/non-function issue #122===
 +
<p>Missing or mis-placed subsurface definition in global block can cause crash or give the indication the
 +
subsurface feature is working when it is not. I run with this parser hack as protection pending
 +
a more complete fix.</p> 
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git fix/subsurfaceCrash_Issue122_FS306</code></p>
 +
 
 +
===Fix. Improved unix Simple DirectMedia Layer messages===
 +
<p>See pull req or commit message for more information.</p>
 +
 
 +
<p><code>git pull https://github.com/wfpokorny/povray.git fix/unixSimpleDirectMediaLayerMessages</code></p>
 +
 
 +
<p>Pull request #109 on github.</p>
 +
 
 +
 
 +
==How to merge branches into a custom version of POV-Ray==
 +
<p>Given you've already installed git and have an active local fork of POV-Ray master branches can be merged on linux with:</p>
 +
 
 +
<pre>
 +
git checkout master
 +
git branch povraySpecial
 +
git checkout povraySpecial
 +
git pull https://github.com/wfpokorny/povray.git fix/unixSimpleDirectMediaLayerMessages
 +
... Usual prebuild.sh, configure and make ...
 +
</pre>
 +
 
 +
==Incomplete section==
  
 
[[User:Wfpokorny/HowTo| How to get sub page...]]
 
[[User:Wfpokorny/HowTo| How to get sub page...]]
 
=Thing=
 
==Sub Thing==
 
===Sub Sub Thing===
 
====Sub Sub Sub Thing====
 
=====Sub Sub Sub Sub Thing=====
 

Revision as of 15:18, 27 November 2016


The Playpen

A bit of documentation for items currently in my POV-Ray playpen.

Git Branches on github

I'm maintaining my POV-Ray patches as un-merged github branches to make it easier for me to keep them current with the POV-Ray master branch. In my own space I occasionally create my own version of POV-Ray which includes just the branches/patches of mine and others that I want.

Pointers to my active branches follow with the thought some might be generally useful to others in rolling their own versions of POV-Ray.

Tune Blob Accuracy

This just tweaks an internal value in blob.cpp that in my testing of blobs over the past year I've found works better. I will eventually package up all my blob test cases and open a github issue/pull request, but not there today...

git pull https://github.com/wfpokorny/povray.git tune/blob_accuracy

Density File Pattern Updates

A three pronged effort to improve .df3 density file pattern support.

  1. Improved user documentation.
  2. Additional array coupled df3 creation and read support. Write support exists.
  3. Fixes and extensions for the density file pattern.

See: Density File Pattern - proposed documentation updates.

git pull https://github.com/wfpokorny/povray.git feature/newDensityPatternInterpolations

Pull request #79 on github.

Allowing image_map use in density block

A more targeted feature addition to the density feature requested by developers. I use the pigment_map branch, which includes this image_map support.

git pull https://github.com/wfpokorny/povray.git feature/image_map_wDensity

Pull request #82 on github.

Addition black_hole warp type(s)

The black_hole warp in master today has just type 0 support so the type is not really documented though the parser picks it up. Further the default sucking black_hole is clamped in movement and it sometimes reaches outside the black_hole range making for interesting effects I've used, but certainly confusing results for any novice. This patch adds a type 1 version of the black_hole warp which duplicates exactly the pushing/inverted form of type 0, but for the sucking form it implements a form more like what folks would expect. The default with this patch is still type 0 so type 1 needs to be specified to use the new type.

git pull https://github.com/wfpokorny/povray.git feature/newBlack_holeTypes

Pull request #86 on github.

Non-portable 32 bit DF3 write capability

Pull request for this rejected as not portable - and I admit I don't understand the particulars. The feature works for me on linux though and I find it useful so I maintain it for my use.

git pull https://github.com/wfpokorny/povray.git feature/nonPortable32bitDF3Write

Both image_map and pigment_map support in density block

Lets one use both image_map and pigment_map in density{} as a way to quickly get full color density/media.

git pull https://github.com/wfpokorny/povray.git feature/pigment_map_wDensity

Unix file and console column wrap control by environment variable

Enabling control of the wrapping via environment variables of POVRAY_CONSOLE_COLUMNS for the console and POVRAY_TEXTSTREAM_COLUMNS for files and console.

Note. There is an active pull req #117 approaching this issue in another way.

git pull https://github.com/wfpokorny/povray.git feature/unixConsoleFileColumnWrapControl

Fix. Rejected parser check for subsurface crash/non-function issue #122

Missing or mis-placed subsurface definition in global block can cause crash or give the indication the subsurface feature is working when it is not. I run with this parser hack as protection pending a more complete fix.

git pull https://github.com/wfpokorny/povray.git fix/subsurfaceCrash_Issue122_FS306

Fix. Improved unix Simple DirectMedia Layer messages

See pull req or commit message for more information.

git pull https://github.com/wfpokorny/povray.git fix/unixSimpleDirectMediaLayerMessages

Pull request #109 on github.


How to merge branches into a custom version of POV-Ray

Given you've already installed git and have an active local fork of POV-Ray master branches can be merged on linux with:

git checkout master 
git branch povraySpecial
git checkout povraySpecial
git pull https://github.com/wfpokorny/povray.git fix/unixSimpleDirectMediaLayerMessages
... Usual prebuild.sh, configure and make ... 

Incomplete section

How to get sub page...