cPicture-plugins

Plugins for the cPicture App

cPicture supports function plug-ins to process/display selected pictures.
The Plug-In is a DLL-File located in the same folder as cPicture and starts with 'cpp_'. For example 'cpp_fp1.dll'.
Click the function plug-ins button in the menu ribbon to display all installed plug-ins.

Sample 1

Sample 2

Sample 3

.bat Script

The script files need to be in the same folder. You can use max 255 scripts.

example.bat file:

@echo OFF

echo file  =%1
echo name  =%2
echo path  =%3
echo width =%4
echo height=%5
echo sequence number=%6 
echo number of files=%7


REM "Press any key to continue ..."
pause

Powershell script

example.ps1

$picture_data_set = ConvertFrom-Json -InputObject $picture_data_json

# Print the number of pictures.
[int]$size = $picture_data_set.length
Write-Host "$size picture(s):" -ForegroundColor White
Write-Host ("-" * 15)
Write-Host

# Print the picture data.
[int]$i = 1
foreach ($picture_data in $picture_data_set) {

    [int]$MP = $picture_data.width * $picture_data.height / 1000000
    "Image '{0}' ({4} of {5}) with {1}x{2} pixel ({3}MP)" -f $picture_data.file, $picture_data.width, $picture_data.height, $MP, $i, $size
    "  name='$($picture_data.name)', dir='$($picture_data.dir)'`n"

    "-" * 70

    $i++
}

HDR enfuse

This plugin uses the enfuse tool to create a HDR picture from at least 2 pictures.

ASCII Art

Function plugin to convert a picture into ASCII art.

Time Capsule

Builds a shareable poster from the current selection with thumbnails, timeline-style ordering and metadata summary.

X-Ray

Creates an analysis board for each selected picture with edge, block-boundary and combined heat maps without any AI dependency.

Motion Composer

Merges a sequence into a single motion-heavy composite image with colored trails.

Postage

Creates a new picture that looks like a simple postage stamp with a perforated border, value text and optional stamp overlay.

Structure and details

A function plug-ins will be executed in 3 steps. The following example displays a message box for each step.

Step 1

The function start(...) will be called with a list of all selected pictures. In this first sample, all picture names will displayed in the message box:

Step 2

The function process_picture(...) will be called for each selected picture:

Step 3

The funktion end() will be called last:

The return value determines which pictures were modified/deleted or added. cPicture adjusts the display accordingly.

cPicture can supply each picture with additional picture data. This is controlled by the return value of start(...). With this you can easily create external display applications (example above) or simply call a script or an external program. The execution stops if the return value is set to 'false'.

Linker base addresses

Currently used base addresses:

cpf_tiff_png: 0x180000000
cpf_pdf: 0x181000000
cpp_fp1: 0x201000000
cpp_fp2: 0x202000000
cpp_fp3: 0x203000000
cpp_fp4: 0x204000000
cpp_fp5: 0x205000000
cpp_script: 0x210000000
cpp_fp_hdr: 0x212000000
cpp_fp_ev: 0x213000000
cpp_ascii_art: 0x214000000
cpp_copy_cb: 0x215000000
cpp_qrcode: 0x216000000
cpp_timecapsule: 0x217000000
cpp_xray: 0x218000000
cpp_motion_composer: 0x219000000
cpp_postage: 0x21A000000