openscad/BOSL2
1
0
Fork 0
mirror of https://github.com/revarbat/BOSL2.git synced 2025-08-09 07:26:36 +02:00
Code Issues Projects Releases Wiki Activity

Update skin.scad

Browse Source
This commit is contained in:
Richard Milewski
2025-06-22 17:53:44 -07:00
parent 34f9136b6a
commit fd82d27a18
1 changed files with 42 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

82
skin.scad
View File

@@ -17,7 +17,6 @@
__vnf_no_n_mesg=" texture is a VNF so it does not accept n. Set sample rate for VNF textures using the tex_samples parameter to cyl(), linear_sweep(), or rotate_sweep().";
// Section: Skin and sweep
// Function&Module: skin()
// Synopsis: Connect a sequence of arbitrary polygons into a 3D object.
// SynTags: VNF, Geom
@@ -3526,7 +3525,7 @@ function associate_vertices(polygons, split, curpoly=0) =
)
associate_vertices(newpoly, split, curpoly+1);
// Section: Texturing
// Section: Introduction to Texturing
// Some operations are able to add texture to the objects they create. A texture can be any regularly repeated variation in the height of the surface.
// To define a texture you need to specify how the height should vary over a rectangular block that is repeated to tile the object. Because textures
// are based on rectangular tiling, this means adding textures to curved shapes may result in distortion of the basic texture unit. For example, if you
@@ -3695,6 +3694,47 @@ function associate_vertices(polygons, split, curpoly=0) =
// cyl(d=10,h=15,texture=tex, tex_reps=[4,2],tex_samples=5,rounding=2);
// up(7)fwd(-3)right(15)cyl(d=10,h=15,texture=vnf_triangulate(tex), tex_reps=[4,2],tex_samples=5,rounding=2);
//
// Subsection: Textures from Graphic Images
// The BOSL2 scripts folder contains three scripts for creating texture arrays from graphic images.
// .
// - [**img2scad.py**](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/scripts/img2scad.py)
// is a python script that creates a texture array from most common raster image formats, including gif, png, jpeg.
// .
// - [**img2scad.html**](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/scripts/img2scad.html)
// contains a javascript creates a texture array from any image your browser can render.
// .
// - [**geotiff2scad.py**](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/scripts/geotiff2scad.py)
// is a python script creates a texture array from geotiff depth maps.
// .
// Each of these scripts places a named array in an .scad file with names specified at run time. Use include<> to add the array to your model.
// .
// Both **img2scad.py** and **img2scad.html** provide similar capabilities, but the html script has a few additional capabilities
// and it provides a graphical user interface..
// .
// On the right is a {{textured_tile()}} with the texture array created by **img2scad.html** from the .png file on the left:
// .
// ![Textured Tile](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/images/WilburTex01.png)
// .
// The image luminance is directly translated into texture depth in the example above. Better results can be obtained by passing
// the original image through an AI image processor to produce a depth map from the image before creating the texture array.
// .
// ![Texture Tile](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/images/WilburTex02.png)
// .
// AI image processing tool and workflows are still evolving rapidly. See the [discussion](https://github.com/BelfrySCAD/BOSL2/discussions/1731) on depth map workflows for current best practices.
// .
// Sources of whole planet GeoTIFF Data include:
// * [USGS Astrogeology Science Center](https://astrogeology.usgs.gov/search)
// * [NASA PDS (Planetary Data System)](https://pds.nasa.gov)
// * [OpenPlanetaryMap / OpenPlanetary](https://github.com/OpenPlanetary/opm)
// .
// GeoTIFF data for smaller areas comes from the Space Shuttle Radar Topography Mission. Data covering about 80% of the Earth's surface
// is available from [Earthdata](https://www.earthdata.nasa.gov/data/instruments/srtm/data-access-tools)
// .
// A globe created using the **geotiff2scad.py** script to generate the texture array:
// .
// ![Geotiff Example](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/images/globe_animation.gif)
// .
// Section: Texturing
// Function: texture()
// Topics: Textures, Knurling
// Synopsis: Produce a standard texture.
@@ -5260,42 +5300,4 @@ function _resample_point_array(data, size, col_wrap=false, row_wrap=false) =
]
];
// Subsection: Textures from Graphic Images
// The BOSL2 scripts folder contains three scripts for creating texture arrays from graphic images.
// .
// - **img2scad.py** is a python script that creates a texture array from most common raster image formats, including gif, png, jpeg.
// .
// - **img2scad.html** contains a javascript creates a texture array from any image your browser can render.
// .
// - **geotiff2scad.py** is a python script creates a texture array from geotiff depth maps.
// .
// Each of these scripts places a named array in an .scad file with names specified at run time. Use include<> to add the array to your model.
// .
// Both **img2scad.py** and **img2scad.html** provide similar capabilities, but the html script has a few additional capabilities
// and it provides a graphical user interface..
// .
// On the right is a {{textured_tile()}} with the texture array created by **img2scad.html** from the .png file on the left:
// .
// ![Textured Tile](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/images/WilburTex01.png)
// .
// The image luminance is directly translated into texture depth in the example above. Better results can be obtained by passing
// the original image through an AI image processor to produce a depth map from the image before creating the texture array.
// .
// ![Texture Tile](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/images/WilburTex02.png)
// .
// AI image processing tool and workflows are still evolving rapidly. See the [discussion](https://github.com/BelfrySCAD/BOSL2/discussions/1731) on depth map workflows for current best practices.
// .
// Sources of whole planet GeoTIFF Data include:
// * [USGS Astrogeology Science Center](https://astrogeology.usgs.gov/search)
// * [NASA PDS (Planetary Data System)](https://pds.nasa.gov)
// * [OpenPlanetaryMap / OpenPlanetary](https://github.com/OpenPlanetary/opm)
// .
// GeoTIFF data for smaller areas comes from the Space Shuttle Radar Topography Mission. Data covering about 80% of the Earth's surface
// is available from [Earthdata](https://www.earthdata.nasa.gov/data/instruments/srtm/data-access-tools)
// .
// A globe created using the **geotiff2scad.py** script to generate the texture array:
// .
// ![Geotiff Example](https://raw.githubusercontent.com/BelfrySCAD/BOSL2/master/images/globe_animation.gif)
// .
// vim: expandtab tabstop=4 shiftwidth=4 softtabstop=4 nowrap