Macro Texture

Description
This small macro allows you to build a project 3D very easily from a bitmap image 256 levels of gray.

I hope that this macro will revolutionize the way of thinking the CAD and CNC any image when what can be converted to object 3D without any intervention.

Everything becomes possible regardless of the complexity of the image !



Use
This macro need an image in 256 gray levels (0-255) therefore before using the macro, convert your image into grayscale (black and white) Lowe. The number of colors is detected automatically, if the image is more than 256 colors another function is expected (to come). Each color (gray level) is regarded as a deep, white (255) the level high and black (0) the lowest level (deep).

Configuration is done before the opening of the file, default values are the settings provided to get a project's dimensions:
 * width of the image in points in the coordinate X,
 * height of the image in points in the coordinate Y,
 * depth or thickness of the project leaked 10 mm (in raw mode, on 256 mm) in the coordinate Z.

The image file unfolds like a scanner x1 x2 x3 ... in 1 mm increments in FreeCAD similarly to the value y of 1 mm at a time. The value of z is given by the value of the color. These values are configurable in the macro.

Attention: depending on the size of the image, the project can become very big! for the record an image of 100 px wide and 100 px in height gives 100 x 100 = 10000 points 'and as each point corresponds to a coordinate, so 10000 coordinates XYZ there.

The interface



 * Coordinate X: X coordinate of position of the object, default: 0.
 * Coordinate Y: Y coordinate of position of the object, default: 0.
 * Coordinate Z: coordinate Z position of the object, default: 0.
 * Stetching X: narrowing or enlargement of the length of the object, default: 0.
 * Stetching Y: narrowing or enlargement of the height of the object, default: 0.
 * Stetching Z: narrowing or enlargement of the depth of the object, default: 0.
 * Raw mode: to adjust the number of colors (depth). The default mode is 0-19 (which constitutes a filter and to obtain more details according to the complexity of the image) once the checked the mode is 0 to 255 (the entire range of colors).
 * Capping: the capping function can be made on the choice of colours, white (default) or black. The degrees of capping rule 19 to 0 (or 255 to 0) if the checkbox is set on W (unchecked) or 0 to 19 (or 0 to 255) if the checkbox is set on B (checked).
 * Raw mode: to adjust the number of colors (depth). The default mode is 0-19 (which constitutes a filter and to obtain more details according to the complexity of the image) once the checked the mode is 0 to 255 (the entire range of colors).
 * Capping: the capping function can be made on the choice of colours, white (default) or black. The degrees of capping rule 19 to 0 (or 255 to 0) if the checkbox is set on W (unchecked) or 0 to 19 (or 0 to 255) if the checkbox is set on B (checked).

The beginning of the operation value automatically adapts to the selected function: 0 if the setting is on black (B lack) 255 or 19 if the setting is white (W hite)
 * Wire: build your line (vector) in the form of Wire.
 * Bspline: build your line (vector) in the form of Bspline.
 * Point: creates a point at each pixel (vector).
 * Inversion X: reverse coordinates X image.
 * Inversion Y: reverse coordinates Y image.
 * Inversion Z: reverse coordinates Z image.
 * Draft: not yet used.
 * Plan: not yet used.
 * Backgr. : not yet used.
 * File and lauch: opens the image file and launches the conversion.
 * Quit: exits the function.
 * Backgr. : not yet used.
 * File and lauch: opens the image file and launches the conversion.
 * Quit: exits the function.
 * Quit: exits the function.

Script
FCTexture.FCMacro

Example
The images were inclined to enhance the 3D effect.

Links
The discussion on the forum to give your impressions or contact me.