RealBrush: Painting with Examples of Physical Media
Jingwan Lu, Connelly Barnes, Stephen DiVerdi, Adam Finkelstein

Contact: jingwan.lu.cynthia@gmail.com
Updated 4/19/2013
The executable for the data processing system will be available soon.

==================================================================
Shape (isolated stroke exemplars) :

30 black charcoal (charcoal1, charcoal2)
25 dry_watercolor
22 fingercolor1
16 glitter
17 lipgloss (lipcolor1)
23 lipcolor2
23 lipcolor3
25 lipstick1
14 marker
22 mixedGel
38 regular oil (oil0)
18 thick oil (oil2)
10 oil with spunge (oil3)
20 pastel1
22 pencil
22 pencilSmudged (the pencil exemplars smudged with finger on top)
24 playdoh (plasticine)
18 toothpaste1
31 western watercolor (watercolor1, watercolor2)

****Directory structure:

--Input to our data processing system: 
1. [folderName].png : all the strokes of the medium
2. [folderName]_mask.png : optional binary mask (if not provided, will be calculated)
3. [folderName]_alpha.png : optional alpha mask (if not provided, will be calculated)
4. [folderName].ends : user clicks the start and end position of each stroke in our system
5. [folderName].path : user traces the spine of the stroke along the stroking direction in our system
6. [folderName].strokeList : 
first line: # strokes
each line: the filename of each stroke, the dimension of [folderName].png

--Output from our data processing system and input to RealBrush:
1. [folderName]_stroke[index].png : extracted individual strokes
2. [folderName]_stroke[index].txt : 
	first line: # samples
	each line contains the info of one sample. The range of the numbers is from 0 to 1. 
	From left to right, each line contains
	(1) right rib x, y coordinates relative to [folderName].png
	(2) spine x, y coordinates relative to [folderName].png
	(3) left rib x, y coordinates relative to [folderName].png
	(4) right rib x, y coordinates relative to [folderName]_stroke[index].png
	(5) spine x, y coordinates relative to [folderName]_stroke[index].png
	(6) left rib x, y coordinates relative [folderName]_stroke[index].png
	altogether 12 numbers per line
3. [folderName]_stroke[index]_alphamask.png : The extracted individual alpha masks 
4. [folderName]_stroke[index]_tightmask.png : The extracted individual binary mask

==================================================================
Smear (pairs of strokes of different color overlap):

8 pastel
27 oil
13 playdoh

****Directory structure:

--Input to our data processing system:
1. overlap[index].png : one pair of overlapping strokes
2. overlap[index]_backmask.png, overlap[index]_frontmask.png : the binary masks for the front and back strokes
3. overlap[index].ends : user clicks the start and end position of the back and then the front stroke in our system
4. overlap[index].path : user traces the spine of the back and then the front stroke in our system
5. overlap[index]_before.png : optional, appearance of background stroke before smeared

--Output from our data processing system and input to RealBrush:
[folderName].smearList :
	first line: # strokes
	each line: the filename of the pair 

For each pair of smear:
1. overlap[index]_proportion.png : red channel contains the extracted mixing proportion. blue channel contains binary mask of the interaction region. green channel contains the binary mask of the overlap region.
2. overlap[index].txt : contain the vectorization info for the backstroke and the front stroke
each line contains the x, y coordinates of the right rib, the spine and the left rib. (0 - 1)
3. overlap[index].smearContour : contain the interaction region vectorization info
	first line: # polylines to represent interaction region, three indices of the spine sample that intersect the overlap and training region
	For each polyline:
		there is a line indicating the general information of the polyline:
		side [polyline index] [#samples] [arclength of polyline]
	The following lines contain the x, y coordinates of the polyline samples

==================================================================
Smudge (stroke smudged with clean brush or finger:

15 lipstick smudges
12 oil smudges
10 pencil smudges
11 playdoh smudges

****Directory structure:

--Input to our data processing system:
1. smudge[index].png : one pair of smudged stroke
2. smudge[index]_backmask.png, smudge[index]_frontmask.png : the masks for the front and back strokes. The front mask is alpha attenuated along the left, right and top sides of the overlap region for synthesis purpose.
3. smudge[index].ends and smudge[index].path : similar to smear exemplars
4. smudge[index]_before.png : optional, appearance of background stroke before smudged

--Output from our data processing system and input to RealBrush:
[folderName].smearList : similar to smear exemplars

For each pair of smudge:
The same sets of file as smear exemplars
1. smudge[index]_proportion.png
2. smudge[index].txt
3. smudge[index].smearContour