mcjDespeckleFrontEnd





Purpose
This is a Front End for the Windows-PC utility named mcjDespeckle.exe

This front end is a script for Daz Studio 1,2,3,4

mcjDespeckle.exe can be used independently from Daz Studio
but you have to very carefully type the commands in a 1970's style "shell" window

mcjDespeckleFrontEnd gives lets you control mcjDespeckle.exe through a Daz Studio dialog/window

The download page for mcjDespeckle.exe is there : https://sites.google.com/site/mcasualsdazscripts7/mcjdespeckle

Images rendered using "path tracing" renderers like iRay, Blender Cycles, LuxRender/Reality, octane, etc.
often exhibit bright specs of light. This nasty effect is strongest when rendering scenes with small punctual light sources
and when there are glossy objects in the scene.

mcjDespeckle.exe is a windows-PC application will take your image, detect  the defective pixels and replace them with the average color of the pixels around ithem.


History
July 3d 2016 7:37PM - the despeckling of sequences of files using the "Out" suffix method now works
June 9th 2016 4AM released





Installation

Be sure to install mcjDespeckle.exe wherever you please

download it here https://sites.google.com/site/mcasualsdazscripts7/mcjdespeckle

a good location could be c:\Program Files (x86)\mcasual\

but you can also put it in your private folder(s)


Then install mcjDespeckleFrontEnd.dsa this way:


The zip package is found at the bottom of this page

unzip it in your daz content folder, 


typically :


C:\Users\USERNAME\Documents\DAZ 3D\Studio\My Library


once installed, it will appear in your content library, under 


My Library / Scripts / mcasual 


Starting with Windows 7 if you right click on the downloaded zip file


and select the [Extract All ....] pop-up menu item

you simply browse up to your Daz Studio Content Folder

and the files will fall in the proper folder 



Use

 1 - Launch the script, which should be in your daz content ... /scripts/mcasual/mcjdespecklefrontend.dsa

2 -  Click on the "browse" button on the right side of the "Location of mcjDespeckle.exe" section.  Browse to mcjDespeckle.exe and select it. This needed to be done only once.

3 - Click on the "browse" button on the right side of the "Input image" section. Browse to the image you want to despeckle. If your image was part of a sequence of renders, the filename will comport a number and mcjDespeckleFrontEnd will be able to process the whole sequence in one shot.

4 - In the "Output image filename options", you have 2 options. 
  • - First option, the output image(s) will have the same location, file name and extension as the input image(s) , except that the suffix "Out" will be appended to the file name.
  • Second option, You will have to specify a location, file name and file type in the section titled "Output Image Location, Name, type" 
5 - The dangerous checkbox, titled "Allow Output File(s) To Overwrite Existing File(s), really ?" This checkbox will always return to the default non-checked state when you exit.  if you checkmark this box and your output image has the same location, name, and type as an existing image, it will overwrite it , it will be gone forever!

6 - Adjust the filter strength using the slider in the "Filter Settings" section. O is the strongest settings, it filters out most of the specs, but also "eats" some of the image's sharp edges. 2040 is the lightest setting, it will only remove the fully-white pixels surrounded by 8 fully-black pixels.

7 - Filtering ! You have 2 options
  • Click on the "Filter only 1 image" button if you only want to filter the one selected input image
  • Click on the "Filter image series" button if you want to filter all the images which are part of the input image sequence. Example: if you select pic5.jpg and the same folder contains pic1.jpg, pic2.jpg ... pic10.jpg, then those 10 images will be filtered.  If the "Output image filename option" is the first option, then the filtered images will end up in the same folder with names picOut1.jpg, picOut2.jpg ... picOut10.jpg. If the "Output image filename options" is the second option, and you specified C:\here\moviepic.png in the "Output Image Location, Name, type" section then the files generated will be placed in the C:\here folder and have the names moviepic1.png , moviepic2.png ... moviepic10.png 



License
// =====================================================================
// by mCasual/Jacques
// You can use this script freely for personal or commercial use. 
// You may not sell, resell, sub-license or rent this script in any way. 
// you may credit this script to mCasual/Jacques 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 
// OTHER DEALINGS IN THE SOFTWARE.
// ===================================================================== 







ċ
mcjDespeckleFrontEnd.zip
(25k)
mCasual Jacques,
Jul 3, 2016, 4:36 PM
v.2
Comments