Import images into CavePainting - Revision history

Johannes Novotny at 15:47, 12 September 2017

2017-09-12T15:47:47Z

← Older revision		Revision as of 15:47, 12 September 2017
Line 71:		Line 71:
	To import images into [[CavePainting]], follow these steps:		To import images into [[CavePainting]], follow these steps:

	* Prepare the ~~slide~~ (and optional ~~mask~~) in your program of choice		* Prepare the slides (and optional masks) in your program of choice
	* Rename the ~~file~~ as described above		* Rename the files as described above
	* Copy the images to a USB ~~key~~		* Copy the images to a USB flash drive
	* Insert the USB ~~key~~ into the Windows ~~kiosk~~ machine ~~(the port is on the left side)~~		* Insert the USB flash drive into the Windows machine
	* Swipe kiosk screen left to right until the Windows taskbar is visible on the bottom
	* Open the Windows File Browser from the taskbar		* Open the Windows File Browser from the taskbar
	* Navigate to your USB ~~key~~ on the left panel of the File Browser		* Navigate to your USB flash drive on the left panel of the File Browser
	* Copy the image data you wish to transfer		* Copy the image data you wish to transfer
	* ~~Navigate to~~ the "~~share~~" link on the ~~left panel of the File Browser~~		* Open the "CS137 - Student Directories" link on the desktop and navigate to your user directory
	* Navigate to your ~~home~~ directory ~~at cs137\students\${your_username}~~		* Paste your image files to your user directory
	* Paste your image files to your ~~home~~ directory
	* Eject your USB key		* Eject your USB key
	* Start or restart Cavepainting		* Start or restart Cavepainting
	* Tap the VRG3D window to give it focus
	* Enjoy your data!		* Enjoy your data!

Connor Gramazio at 19:22, 22 October 2013

2013-10-22T19:22:13Z

← Older revision		Revision as of 19:22, 22 October 2013
Line 8:		Line 8:
	* When creating an alpha mask make sure that the alpha mask is ''only'' black and white. Some applications like photoshop use antialiasing when you delete a section which uses the entire gray scale.		* When creating an alpha mask make sure that the alpha mask is ''only'' black and white. Some applications like photoshop use antialiasing when you delete a section which uses the entire gray scale.
	** This usually manifests as the cave screen going blank when you launch your account, but other accounts booting up just fine.		** This usually manifests as the cave screen going blank when you launch your account, but other accounts booting up just fine.
			* Make sure that your image is in RGB, not CYMK or some other format.

	== Color Palettes ==		== Color Palettes ==

Connor Gramazio: /* Common Problems */

2013-10-22T17:40:08Z

Common Problems

← Older revision		Revision as of 17:40, 22 October 2013
Line 5:		Line 5:

	== Common Problems ==		== Common Problems ==
	Sometimes having spaces in the names of images can cause problems. To avoid this use snake_case or cameCase for your file names.		* Sometimes having spaces in the names of images can cause problems. To avoid this use snake_case or cameCase for your file names.
			* When creating an alpha mask make sure that the alpha mask is ''only'' black and white. Some applications like photoshop use antialiasing when you delete a section which uses the entire gray scale.
			** This usually manifests as the cave screen going blank when you launch your account, but other accounts booting up just fine.

	== Color Palettes ==		== Color Palettes ==

Connor Gramazio at 13:07, 22 October 2013

2013-10-22T13:07:02Z

← Older revision		Revision as of 13:07, 22 October 2013
Line 3:		Line 3:
	= Image Format =		= Image Format =
	All images used in CavePainting must be JPEGs (extension .jpg) in RGB color mode (not grayscale, etc.). The mode of an image can be set in the menu item Image>Mode. In the filename patterns described below, an asterisk (<tt>*</tt>) indicates any text you want. The program loads all your images on startup, so if CavePainting fails to start properly, new images that you're loading for the first time may be to blame. Check the [[Troubleshoot CavePainting startup crashes]] HOWTO for instructions on fixing your images.		All images used in CavePainting must be JPEGs (extension .jpg) in RGB color mode (not grayscale, etc.). The mode of an image can be set in the menu item Image>Mode. In the filename patterns described below, an asterisk (<tt>*</tt>) indicates any text you want. The program loads all your images on startup, so if CavePainting fails to start properly, new images that you're loading for the first time may be to blame. Check the [[Troubleshoot CavePainting startup crashes]] HOWTO for instructions on fixing your images.

			== Common Problems ==
			Sometimes having spaces in the names of images can cause problems. To avoid this use snake_case or cameCase for your file names.

	== Color Palettes ==		== Color Palettes ==

Ryan Cabeen: /* Loading Images */

2013-09-19T15:06:43Z

Loading Images

← Older revision		Revision as of 15:06, 19 September 2013
Line 63:		Line 63:

	= Loading Images =		= Loading Images =
	To import images into [[CavePainting]], ~~log into any of the black computers in the Cave room. They are named <tt>dev1</tt> through <tt>dev4</tt>.~~		To import images into [[CavePainting]], follow these steps:

	~~== Setup ==~~		* Prepare the slide (and optional mask) in your program of choice
	~~You have~~ to do a ~~little bit of setup~~ the ~~first time you import images. After that, you should be able to just follow~~ the ~~steps in~~ the ~~next section.~~		* Rename the file as described above
			* Copy the images to a USB key
	~~# Right-click~~ on the ~~desktop and select "~~Open ~~Terminal".~~		* Insert the USB key into the Windows kiosk machine (the port is on the left side)
	~~# In~~ the ~~window that opens, type <pre>/share/cs137/cs137-init</pre> and hit enter.~~		* Swipe kiosk screen left to right until the Windows taskbar is visible on the bottom
	~~# Close~~ the ~~window.~~		* Open the Windows File Browser from the taskbar
			* Navigate to your USB key on the left panel of the File Browser
	~~This step creates a folder~~ on ~~your desktop called "CavePainting Directory". This is where all your files go. If you ever don't see this directory, just repeat~~ the ~~steps above.~~		* Copy the image data you wish to transfer
			* Navigate to the "share" link on the left panel of the File Browser
	~~== Transferring Files ==~~		* Navigate to your home directory at cs137\students\${your_username}
	~~To load files into CavePainting, you need to get them onto one~~ of the ~~black computers in~~ the ~~Cave. You can do this by plugging a keydrive into the front of the computer, emailing files~~ to ~~yourself, uploading files~~ to ~~some server, or any other way you choose. Whatever you do, download~~ the ~~files to your desktop, and then drag-and-drop them into the folder called~~ "~~CavePainting Directory~~" ~~that you see~~ on the ~~desktop.~~		* Paste your image files to your home directory
			* Eject your USB key
	~~'''Before you leave the Cave, be sure you quit properly:'''~~		* Start or restart Cavepainting
	* ~~If you used a~~ USB ~~keydrive, right-click on its icon and select "Remove Hardware"~~ or ~~"Safely Remove" or "Unmount". If you just unplug~~ the ~~keydrive, you might corrupt the data on~~ it ~~and confuse the computer.~~		* Tap the VRG3D window to give it focus
	* ~~Log out of the computer so nobody else can use~~ your ~~account.~~		* Enjoy your data!

	~~That's it~~! The next time you open up CavePainting, your new images should be enabled. If you don't see them in the palette where you expect them, try pushing the button on the non-brush controller to switch palettes.

	= Using Images =		= Using Images =

Ryan Cabeen: /* Image Format */

2013-09-19T14:56:14Z

Image Format

← Older revision		Revision as of 14:56, 19 September 2013
Line 2:		Line 2:

	= Image Format =		= Image Format =
	All images used in CavePainting must be JPEGs (extension .jpg) in RGB color mode (not grayscale, etc.). In the filename patterns described below, an asterisk (<tt>*</tt>) indicates any text you want. The program loads all your images on startup, so if CavePainting fails to start properly, new images that you're loading for the first time may be to blame. Check the [[Troubleshoot CavePainting startup crashes]] HOWTO for instructions on fixing your images.		All images used in CavePainting must be JPEGs (extension .jpg) in RGB color mode (not grayscale, etc.). The mode of an image can be set in the menu item Image>Mode. In the filename patterns described below, an asterisk (<tt>*</tt>) indicates any text you want. The program loads all your images on startup, so if CavePainting fails to start properly, new images that you're loading for the first time may be to blame. Check the [[Troubleshoot CavePainting startup crashes]] HOWTO for instructions on fixing your images.

	== Color Palettes ==		== Color Palettes ==

Ryan Cabeen: /* Slides */

2013-09-19T14:55:09Z

Slides

← Older revision		Revision as of 14:55, 19 September 2013
Line 30:		Line 30:
	\| Mask		\| Mask
	\| <tt>alphamask*.jpg</tt>		\| <tt>alphamask*.jpg</tt>
	\| A black-and-white image matching the picture. The picture is visible where the mask is white, and it's transparent where the mask is black.		\| A black-and-white image matching the picture. The picture is visible where the mask is white, and it's transparent where the mask is black. Make sure the color mode is not grayscale.
	\|}		\|}

Ryan Cabeen: /* Slides */

2013-09-19T14:54:26Z

Slides

← Older revision		Revision as of 14:54, 19 September 2013
Line 14:		Line 14:

	== Slides ==		== Slides ==
	Slides, also known as "billboards", are flat images that you can place in virtual space like floating pieces of paper. Each slide depends on two files, a picture and a mask, which must be the same size and have matching filename patterns.		Slides, also known as "billboards", are flat images that you can place in virtual space like floating pieces of paper. Each slide depends on two files, a picture and a mask, which must be the same size and have matching filename patterns. Also, the slides must be square (equal width and height) and have dimensions that are powers of 2 (64, 128, 256, 512, 1024, 2048, or 4096).

	{\| {{Prettytable}}		{\| {{Prettytable}}

Ryan Cabeen at 14:52, 19 September 2013

2013-09-19T14:52:05Z

← Older revision		Revision as of 14:52, 19 September 2013
Line 2:		Line 2:

	= Image Format =		= Image Format =
	All images used in CavePainting must be JPEGs (extension .jpg). In the filename patterns described below, an asterisk (<tt>*</tt>) indicates any text you want. The program loads all your images on startup, so if CavePainting fails to start properly, new images that you're loading for the first time may be to blame. Check the [[Troubleshoot CavePainting startup crashes]] HOWTO for instructions on fixing your images.		All images used in CavePainting must be JPEGs (extension .jpg) in RGB color mode (not grayscale, etc.). In the filename patterns described below, an asterisk (<tt>*</tt>) indicates any text you want. The program loads all your images on startup, so if CavePainting fails to start properly, new images that you're loading for the first time may be to blame. Check the [[Troubleshoot CavePainting startup crashes]] HOWTO for instructions on fixing your images.

	== Color Palettes ==		== Color Palettes ==

Jadrian Miles at 22:26, 12 January 2009

2009-01-12T22:26:31Z

← Older revision		Revision as of 22:26, 12 January 2009
Line 9:		Line 9:
	{\| align="center"		{\| align="center"
	\|-		\|-
	\| valign="top" \| [[Image:color-swatch-table_example.jpg\|none\|thumb\|256px\|<tt>[[:Image:color-swatch-table_example.jpg\|color-swatch-table_example.jpg]]</tt> ~~—~~ one of the default CavePainting color palettes.]]		\| valign="top" \| [[Image:color-swatch-table_example.jpg\|none\|thumb\|256px\|<tt>[[:Image:color-swatch-table_example.jpg\|color-swatch-table_example.jpg]]</tt> --- one of the default CavePainting color palettes.]]
	\| valign="top" \| [[Image:color-swatch-table_sam-ballardini.jpg\|none\|thumb\|256px\|<tt>[[:Image:color-swatch-table_sam-ballardini.jpg\|color-swatch-table_sam-ballardini.jpg]]</tt> ~~—~~ an example pallette created by a [[CS137]] student.]]		\| valign="top" \| [[Image:color-swatch-table_sam-ballardini.jpg\|none\|thumb\|256px\|<tt>[[:Image:color-swatch-table_sam-ballardini.jpg\|color-swatch-table_sam-ballardini.jpg]]</tt> --- an example pallette created by a [[CS137]] student.]]
	\|}		\|}

Line 44:		Line 44:
	Palettes of patterns or masks each have 16 entries in them, each of which is a 64x64 image. In order to tell CavePainting what all 16 images are, you import them all in one file, with the square images concatenated together in a row. This gives you 16 64x64 squares lined up in a row, resulting in a 1024x64 JPEG file that you import into the program. See the examples below to get a better idea of what this means.		Palettes of patterns or masks each have 16 entries in them, each of which is a 64x64 image. In order to tell CavePainting what all 16 images are, you import them all in one file, with the square images concatenated together in a row. This gives you 16 64x64 squares lined up in a row, resulting in a 1024x64 JPEG file that you import into the program. See the examples below to get a better idea of what this means.

	The vertical direction in the pattern or mask image is aligned with the direction of the stroke ~~—~~ that is, a pattern that looks like horizontal stripes will result in a brush stroke with stripes across it, whereas a pattern of vertical stripes will result in a brush stroke with stripes along its length.		The vertical direction in the pattern or mask image is aligned with the direction of the stroke --- that is, a pattern that looks like horizontal stripes will result in a brush stroke with stripes across it, whereas a pattern of vertical stripes will result in a brush stroke with stripes along its length.

	=== Stroke Patterns ===		=== Stroke Patterns ===
Line 51:		Line 51:
	The filename format for stroke pattern palettes is <tt>pattern*.jpg</tt>.		The filename format for stroke pattern palettes is <tt>pattern*.jpg</tt>.

	[[Image:Patterns_example.jpg\|center\|thumb\|512px\|<tt>[[:Image:Patterns_example.jpg\|patterns_example.jpg]]</tt> ~~—~~ the default CavePainting stroke pattern palette.]]		[[Image:Patterns_example.jpg\|center\|thumb\|512px\|<tt>[[:Image:Patterns_example.jpg\|patterns_example.jpg]]</tt> --- the default CavePainting stroke pattern palette.]]

	=== Stroke Masks ===		=== Stroke Masks ===
Line 59:		Line 59:


	[[Image:brushtips_example.jpg\|center\|thumb\|512px\|<tt>[[:Image:brushtips_example.jpg\|brushtips_example.jpg]]</tt> ~~—~~ the default CavePainting stroke mask palette.]]		[[Image:brushtips_example.jpg\|center\|thumb\|512px\|<tt>[[:Image:brushtips_example.jpg\|brushtips_example.jpg]]</tt> --- the default CavePainting stroke mask palette.]]
	[[Image:brushtips_dithered.jpg\|center\|thumb\|512px\|<tt>[[:Image:brushtips_dithered.jpg\|brushtips_dithered.jpg]]</tt> ~~—~~ a stroke mask palette for dithered translucency.]]		[[Image:brushtips_dithered.jpg\|center\|thumb\|512px\|<tt>[[:Image:brushtips_dithered.jpg\|brushtips_dithered.jpg]]</tt> --- a stroke mask palette for dithered translucency.]]

	= Loading Images =		= Loading Images =