PDA

View Full Version : The fabled tutorial thread on ViewingDale



Redrobes
02-06-2010, 10:19 PM
I know I promised this tutorial about a year or two ago but now that we had the Jan 2010 challenge and three extra copies went as prizes out I feel compelled to start one now so that the winners can have a go at doing something with it.

ViewingDale is my app and it can be classed as a map making tool, a VTT and a campaign organizer. It is all three tho there are better map maker applications out there, more popular VTTs and other campaign organizers and yet I still feel that it sits apart from anything else so this tutorial is going to cover all three and why I believe that statement to be true.

The app is for windows 2000, and beyond. It is checked on Win2K, XP, XPx64 and I have seen it running well on Vista and Win7 as well as Ubuntu under VirtualBox. The app makes extensive use of the graphics card so it requires one suited to games. NVidia and ATI both being well suited as well as some higher end Intel chip cards & 3DLabs cards too. The app can run without using the graphics card tho its *very* slow. Theres a test program made which is a free download so that you can tell whether your card is suitable and set up correctly for the app.

Little bit of history. I started writing an app around 1991 on the Amiga and it was a vector based line map program. What I wanted was a way to create hierarchies. You make a tree shape and then put several trees together to make a copse, several of them to make a wood, several of them to make a forest. The idea worked but the Amiga being a bit gutless died trying. The problem with that was you have to make every single little shape. By about 2002 I tried again and used images as the tokens instead with OpenGL on the graphics card cos it can shift images about much faster than the CPU.

Lastly in this anecdotal intro, the app is designed to share maps and campaign notes. The whole point of the app is to bring all of your maps together into one giant set and to bring in lots of other DMs maps and put them into one giant repository like the web is for information. I wanted to go anywhere and have it mapped by someone. So given that all the maps drawn by different people would be at different scales the app does not work at any one fixed scale. You never ever need to know the feet per pixel rating of any map or image set for it. Also, there is no complexity limit for the world being mapped and in fact every map is one layer in an infinite set even if that map is the whole world. So one of the design aims of the program is that it can take bits of mapped areas and allow people to connect in and transfer missing bits on their machine from the one who has them. To do this it uses a very efficient method to store the maps. It turned out to be so efficient that you can make changes to the map and connected clients got real time updates and it became a VTT at the same time.

So assuming that you have a boxed disk in front of you ill start with installation and set up.

Redrobes
02-06-2010, 10:39 PM
If you get a download or a boxed disk then you will get an installer which is a standard windows exe installer app. You can install the app anywhere on the PC but I would recommend putting it into a place that has several gigs of free space on it for all of the accumulated art. ViewingDale stores its art in files under the apps main directory. You can divert this to a different place by editing the configuration file but thats not usual.

Before you install its a very good idea to uninstall the trial version that you might have downloaded. The two are not compatible.

When it is installed it will normally put a launch icon on the desktop and a shortcut in the start menu. When you run the app it will load the last map you were looking at or the index page for the first time run. The index page is blue with some circles and text on it.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/IndexPage_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/IndexPage.png)

The circles are links and they will take you to other maps such as the island map that it comes with or the help pages which are all in ViewingDale format. When you see this page its quite possible that your circles are not circular but elliptical and it all looks a bit squashed. This would be true particularly on wide screen monitors. We need to fix this.

ViewingDale works is real world scaling. To get that you must calibrate it to your monitor and this is done by measuring accurately your monitors drawable area in mm. Thats right to the edge of the screen not the window its running in. If you do this and have the width and height then you can use the "Start" button and hit the System Settings button and then the "Screen Width in mm" and "Screen Height in mm" and enter the values in. When finished the page should have exactly circular jump icons on the index page.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/SysSettings1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/SysSettings1.png)

If you happen to be using a large screen or a small screen such as either a projector or a micro tablet PC then it might be a good idea to enter the widths or heights in stages as it will change the screen progressively each time and it might be too squished if you go in one giant step. If you really get stuck then you can close it, edit the configuration file and restart the app. If you are using a projector down onto a table with miniatures then its an especially good idea to enter correct values as then all the maps will always be the correct scale for your miniatures with no more scaling - ever.

If your running a single desktop over multiple monitors then put in the value for the multiple monitors. The app copes well with spanning over multiple monitors providing your using one graphics card driving them or hardware connected cards in SLI mode or whatever fancy setup nVidia has come up with this year.

You should also check your graphics card specs and enter in the amount of RAM it has on it into the system settings menu item for it too. The more RAM your graphics card has the better it will run. I would say 8Mb is absolute minimum, 32 Mb or more is recommended but having 64 or 256 is better. There's a diminishing advantage beyond about 256Mb.

Thats the setting up done. Ill cover patching up next so we can get that out of the way.

Redrobes
02-06-2010, 11:05 PM
On the website there is a download under the support menu for "Versions and Patches". The download gets you a zip file and within is an installer. You can run the installer out of the zip if you want to. It will install a new directory under the main viewingdale install directory called VersionControl. It will probably have put an icon on the desktop which looks like a band aid sticky plaster.

Ensure the app is closed, run the plaster icon by clicking on it. Or go into the VersionControl dir and run the ViewingDalePatcher.exe.

It will analyze what you have and find suitable patches for it and move your app up versions until it gets to the latest. It stores the old set in a directory so you can revert back if need be. It may add extra applications for you too as and when they get developed.

Once finished you can run up the main app and hit the big Menu button and then "About ViewingDale" and it will tell you what version you are running.

Since version 1.03 there exists an x86 and an x64 version of the app. The x86 is the normal 32 bit standard version. The x64 looks and feels exactly the same but is complied for native 64 bit OS'es like XPx64, Vista64 and Windows7 64bit. My recommendation is if your not sure then use the normal 32 bit app but the 64 bit one on 64 bit machines is slightly better only in the increase in memory capability when saving huge bitmaps. Otherwise its exactly the same.

Redrobes
02-07-2010, 09:33 AM
Moving the mouse you will see that most of the time its in the shape of a cross. If you click with the left button then it centers the page on that point. With the right button it grabs the page and slides it around changing the cursor to a hand shape. If you move the cursor over a hot spot circle then it will change to a pointer. When you click with the left button the type of hot spot does different things. Ones with an arrow in like those on the index page are jumps to new map pages. If you click inside the one for the introduction to basic features then it takes you to a new page. Also you will see that a new box appears in the top right corner. This is the jump stack and shows where you have come from.

You need to know how to move around using keys too. The cursor keys pan and the Page Up / Page Down buttons zoom. The Home key centers the page to fit. The backspace key jumps you back up the jump stack - i.e. taking you to the previous map shown. It puts you at the position and zoom that you were at when you jumped from that map.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/MoveKeys1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/MoveKeys1.png)

With the boxed set you get a laminated card showing all the keys. Actually there are a few more than this now that its progressed a few more versions.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/AllKeys1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/AllKeys1.png)

As stated on the image the mouse wheel does zoom too. Another tip is that clicking with the mouse inside the jump stack can take you back to any previous map instead of using the backspace button multiple times.

As you pan and zoom you will see the title bar change its position and scale. The position is in the current units which I will talk about later but it starts in meters. The scale is shown as though you are at 1:X i.e. when it says 60 thats 1:60 scale. Or say 1 inch on screen = 60 inches in map which is 1 inch = 5ft map scale. If you have calibrated your app to the monitor as discussed in the previous message then the scale is real. I.e. if it says 1:1 then what you see on the screen is actual size.

Redrobes
02-07-2010, 04:54 PM
Theres a similar section in the help files within the app covering this but its probably a good thing to reiterate it as its so vital. Incidentally, all the help is in ViewingDale format as is all of the artwork used to make the laminated card, insert, and box cover.

As you recall from the intro what were after is a mechanism to have the whole world at your fingertips and we would like to be able to reuse those tree icons to make copses, woods and forests. What were building here is a hierarchy.

The main view looks at a map. Actually your looking at one layer in an infinite set. This layer is called an icon. An icon is just a bunch of a small set of parameters one of which is a reference to an image. The image is whats shown on the screen and its sized to extents which are parameters in the icon. So you can have two different icons with the same image. I.e. you can have a small chair and a giant chair. Two different icons using same image. Most of the time you have one icon per image because many of the icons are so unique but things like arrows, lines, circles and so on have many icons for the one image. The other thing that an icon has is a list of child icons attached to this one. I.e. for an icon of a village it might have a list of child icons, one for each hut in it. Those child icons are listed with their position, scale and rotations for each one.

So we can have a Forest which has 3 child icons each of type Wood and those have positions and rotations so that they are next to each other making up a little group.

Now if the Wood icon happens to have 6 children called Copse arranged in a little group also then when you view the Forest then it will show its icons image, 3 Wood images and 18 Copse images. And it goes on and on like that. If you add another Wood to the forest then the forest icon gains one more child but 6 more Copse images are also shown.

So the ViewingDale app has controls to edit the icon size, add and remove child icons and to position, rotate and scale the child icons on the main one.

Redrobes
02-07-2010, 05:10 PM
So lets run that again one more time because understand this and its all plain sailing...

Here is a table, a plate, a bowl, a spoon, and some liquid for the bowl. These are images and lets say you have the icons for them that make them all the correct real world size. You put them all down on some surface in this case a white wonderland...


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/Stack1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/Stack1.png)

If you drag these icons over one another then they stack up in size order. You don't get to control the Z order. Small things always go on top of larger objects. Theres a good reason for that which I will show later. You can see also that these images include the transparent background which were all familiar on these forums. The icon size includes the transparent bit so if you really must then you can add more transparent edge to an icon to push it down but that doesn't happen all that often.

Ok so now we have white backdrop with 5 child icons on it whether in a line or stacked up.

If we change the situation so that we make the spoon a child of the plate and the liquid a child of the bowl and call these two new icons Plate_with_Spoon and Bowl_of_Liquid then we can make these two children of the table. Then the white backdrop can have one child of table like this.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/Stack2_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/Stack2.png)

Now if we edit the table icon and move, scale and rotate its Plate_with_Spoon then note that the spoon rotates with the plate, scales with it and moves with it. The spoon is now as though its part of the plate even though its a child of it. In other words the whole hierarchy under the edited icon takes on all the changes to it.

So we can pick up that Forest and move it and all the Woods and Copses move with it, scale with it and rotate with it.

And now you can see that if we make a general village with some huts in it all laid out nicely, then we can use that village in several maps with different rotations and scales and yet at the same time on each of them we could still go in and edit that village and move the individual huts about.

So grouping icons logically in a sensible hierarchy is vital. Putting a hut on a continent is not sensible. You need a set of layers that go from world down to battle map so that at some point there is a region, a village and then you put your hut on that. ViewingDale has various features to make that easy though you can ignore it all and make something unmanageable.

Redrobes
02-07-2010, 05:56 PM
So as you can see were predominately concerned with editing icons and apart from the Normal View mode, there are three more to help out in this regard. These are the Edit Child Mode, the Origin Mode, and the Edit Size Mode which look a little like this:


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ViewModes1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ViewModes1.png)

Origin first as its easy. This mode allows you to set the origin for the current icon. You click with the mouse and it puts the red origin marker down at that spot. This is the point where the icon rotates around or snaps to the grid so its handy to put this in a sensible position like middle of dragons body or hilt of sword or center of pot etc.

The Edit Size mode allows you to change the size of the current icon. The icons is laid out on a grid and you use the arrow keys to stretch it over the grid. The grid dynamically changes scales and the current size is shown on the title bar. In the image this is one big light blue square of 0.1m and 2.5 of the darker finer grid which is 0.02m so thats 0.15m x 0.1m. There are red corner markers showing the extents.

The Edit Child Icons mode allows you to add, remove, move, scale and rotate a child icon. You must keep all of your child icons within the extents of the main current icon. You can grab a child by clicking and holding down the left mouse button inside the red circle handle for each child. From there you can drag it around. If you click inside the green circle handle then moving the mouse will rotate the child towards the mouse. If you grab the child with either red or green and then press + or - key it will scale it off of its default size and if instead you had pressed 0 (zero key) then it snaps the size back to its default. Each child icon has a rectangle around it in red to show its extents including any clear parts to its image.

To add a child you can press 'C' and from the normal view mode it will take you to edit child mode and bring up a file selection box to pick one. If you grab a child and press the Delete key then it removes it. You can also press and hold the delete key down and then move your mouse over a handle and it will delete all in its path that fall under the cursor for more rapid clearance of areas.

Once you have a child grabbed by the red handle you can drag it about. If whilst doing so you press 'C' key then it clones it and drops a copy at the point you pressed it whilst dragging. So you can grab a goblin, and drop clones of them down where you need them. The clones take on the currently dragged goblin scale and rotation too. Once dropped you can go and rotate them or reposition them as you would any other child.

On newer versions you can grab a child and press 'X' or 'Y' to flip in X or Y. Flip is like all the other properties in that its replicated down through the hierarchy below it.

Redrobes
02-07-2010, 06:19 PM
Ok thats icons done to death what about images ?

ViewingDale uses a custom image file format for a number of reasons but the main one is performance. The data is reformatted so that it can display them very fast. Its also adds some tags to the images not present in any of the file formats so that when the app is run it does not have to work these out each time. Anyway suffice it to say that you gotta get your image into VMI format. The app has a built in converter.

By pressing F2 you get the Icons and Images menu and on there is the Import Image option which gives a dialog like this:


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ImageImport1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ImageImport1.png)

You have to load in a color and a transparency image or you can load in a PNG file with both color and transparency. Either way, it will show the image seperated into its color on the left, transparency in the middle and combined on the right. You can import a BMP, JPG or PNG file. You can try a TIF file too and it might work. You can use any image from very small to very large tho if larger than 2048 square then it will resize it down. In fact it will usually resize the import anyway but its very generous and almost always upsamples it using a good algorithm so you don't notice. Anyway, once you have something correct on the right panel you can save that image. It asks you for a name and a directory to place it into. The directory will always be under the Images base directory. ViewingDale will not make icons out of images outside of its directory structure. Theres a good reason for that too... later.

So you should be able to save an image as a VMI file.

There is an app that ships with it which is the batch PNG file converter which will change over a whole directory and subdirectories of PNG files into VMI files. You still need to make icons for them all but at least half the work can be automated.

Thats about all there is to know about images.

Redrobes
02-07-2010, 06:44 PM
There are several ways to create a new icon. The first and most obvious is to tell it which image to use. That can be found under the Menu / Images and Icons or by pressing F2. From there you will see an option "Create New Icon from an Image". With that you run through a sequence of dialog options where it asks you for the name of the new icon then asks where you want to save it then it brings up a similar file selection box where you select the image to use and then it creates that icon for you. Unfortunately it creates it with the origin in the middle and at 1mx1m which is not always the best. The idea is to then edit it and resize it up to be correct.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ImagesAndIcons1.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ImagesAndIcons1.png)

But maybe you knew all along how big this icon was supposed to be. There is now a wizard where you set the name and image to be used and you set the width and height and whether the origin is in the middle or bottom left corner. Most people use this one now because even if you have to edit it your normally closer to where its supposed to be.

There is another option where you can create a new icon which is a clone of an existing icon. With that option you can, for example, take an icon of a chair and make a new one called giantchair and then point it at chair and it will make a new one with same image and same size and origin. Then you can edit it so as to make it much bigger. Then you have two icons sharing the same image but of different sizes. This is also useful when you need different child icons for the same main icon or image. Another good reason to use this option is when you have say an Inn and want to put it down on a city. If you place that Inn down directly then any modifications to that inn will be done across the world. If you clone it you can call it something specific like "TheGreenDragonInnInWaterdeep" or whatever and then it will be unique.

Lastly you can take a screen capture as the image and make a new icon. You supply the name but the size is taken from the screen scale so that its exactly correct to match up with the current view. This is especially useful when you have say a few huts on a regional map and you want to make a new village map and get those huts down onto their own map. You can take a screen shot covering the village, add the huts to that new icon lining them up with the backdrop image then replace the backdrop image with a clear image and put it back on the map. Delete the old huts and allow the new ones to show from the new icon.

There's one more special option. You can create a Contact Sheet of all the icons in a directory. It makes a new clear icon and add one of each icon you have in the selected directory and labels it for you. It names the icon _contactsheet so you will find it at the top of all icons in that directory.

Redrobes
02-07-2010, 07:40 PM
On that menu there is the option to load an icon. Thats the 'L' key and just loads an icon from a file selecton of icon files.

There is no save. ViewingDale saves everything all the time. There is an undo for the child edit by pressing 'U' but normally all actions are done and saved instantly.

The refresh is rarely used as this is only useful if you externally edit a file like an icon text file using a text editor and then you can refresh the screen.

The images and icons are stored as files in directories under the main installation dir. If you pick these file up and move them then they will be badly referenced from child icons or icons will call up bad pathed images. So in order to move these files and fix up all the references to them there are two options to move an icon or move an image. You should use these if you really need to or else you could find yourself looking at text file references to fix !

You can change the current icons image with an option here which can be quite useful.

Set the icons size means to do what the Edit Size mode does only with numeric input. So you can specify that this battle map is exactly 100 yds by 200 yds for example.

Adding a child icon we mentioned earlier.

There are the special icons you can add. The main one is text. By pressing T you get an edit box where you can type in some text, select its color and it will appear as a child icon on the current icon. When editing it you will note that it does not have a green handle because text always rotates so that its horizontal. You must remember that all icons in ViewingDale may be used multiply and in different orientations and scales. The extents box for text is thus circular to depict where text might possible lie at any rotation.

Next on the Child Action types is a jump. You can put down the blue and yellow marker with the arrow on it and select another map to jump to. This is useful for going up stairs entering buildings or just having a list of maps to index.

You can add a link to a document too. That can be a text file, a doc, rich text or whatever. You can set the document reader so if all your docs are PDF say then thats ok too.

Theres picture links too of course. By default the app is tied to the ViewingDale Picture Viewer which is a super fast simple image display. Again tho, you have the option of opening with any image viewer that can take a command line parameter for the image to look at.

You can add a sound link as well which can add some atmosphere to your gameplay.

Next is a web link where you can link to any web page like this one !

Finally there is a general file link. Some caution here is that it will launch whatever file is behind the link. That might not be a good idea if you get the map from someone you dont trust. But there is the possibility that you can run your own program or something unusual.

You can check out some of the links in the demo download. In that mini map is a link to text, a picture, and a jump to another map.

Redrobes
02-09-2010, 05:52 PM
No mapping app would be complete without some grids. By pressing 'G' and 'H' keys it toggles through the three types of grid. There is square grid and two types of hex grid with hexes going horizontally or vertically. So 'G' toggles square grid on and off, 'H' does hex-horz, hex-vert, and then off.

By pressing F3 or using the main menu button you can find the Visual Settings Menu. On here you can see the home key listed, the hot keys for the four view modes then the grid options.


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/VisualSettings1.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/VisualSettings1.png)

From here you can set the grid size which brings up a text box where you enter it in. You can put in "10" for ten meters. You can also put in "10m", "10 meter" or "10 meters" and get the same thing. You can put in "5ft" "5 foot" or "5 feet". You can put in "3.72 inches" or "21.5 miles" "50 yds" "100 yards" or even "20 leagues". It has a wide variety of length units in imperial, metric and some extra ones like "AU" for astronomical units and "ly" or "lightyears" tho to be honest parsecs and lightyears are not worth using. ViewingDale has a map range of about 50 AUs to about 0.1mm

With the 'J' key you can toggle the grid color from black to white.

If you are editing the child icons then you can snap the movement of them to the grid. You need the grid enabled and you must press 'S'. When you do this it will show that you have snap enabled on the menu bar. Now when you grab a child and move it, it snaps to the nearest grid intersection. This is also true of rotate where the grid intersection closest to the mouse is used as the rotation target.

Note that the grid always originates from the current icons origin.

To finish off this menu, the set scale allows you to type in an exact numeric scale instead of zooming to it. Good for when viewing real world sized maps at 1:60 for example.

Hide banner hides the top menu bar, banner, status text thing. Thats useful if your using a projector and want a really uncluttered projection down on the table. With no menus open its all map.

Adjust Child Cut Off we will talk about next...

Redrobes
02-09-2010, 06:11 PM
When editing the child icons I mentioned that all the children should have their extents box within the boundary of the current icons extents. This is not strictly enforced by the app but it does lead to problems with display and screen saves if you don't do it. Its not strictly enforced because if you had some clear bit of the icons image over the edge then it does not matter and the app cant be bothered to keep looking at whether the image is clear or not when your moving.

When you have this hierarchy which is very deep going from the world down to small things like carts with hay bales on the back then the app has to draw that whole world except that its smart enough to know what it needs to and what it can ignore. Firstly anything that's too far off the left or right edges don't need to be drawn and things too small don't need to be either. So how small is too small ? Well that depends and thats what the Child Cut Off limit is all about.

When that option is put up then unlike most of the dialog options, this one a) gets rid of all the parent dialogs leaving just itself behind and b) normally when you open a dialog then it sorta blurs the map but with this one it does not.

It has a red bar and a + and - button. By moving the slider to more and less then when it draws the screen it cuts off drawing small icons based on this limit. Sometimes you really want to see all the detail in the map. So go for a small setting. Sometimes its better if it cuts off the child hierarchy levels much quicker so go large.

When its small the map has more to draw and might take longer if it has a lot of small stuff on it. So to some extent it matters what speed your PC / graphics card is too for the right setting.

Now if a level in your hierarchy is too far to the left or right so that none of it is within the draw area then not only is that icon not displayed but the app assumes that since all the children of it were also within that icon then it does not have to go down any farther and clip the whole hierarchy tree off at that point. So had you have had some children off to the right of an icons boundary and then moved that icon off the screen left then that child would suddenly vanish when its parent left the draw area. So that's why you should not do it.

Now given that in any one scene if you have an area with very small regions on it that have even smaller battle maps going on then it makes no difference how complicated those battle maps are because it wont try to draw them anyway. As you move in on them then sure they need to be drawn but some of the other stuff has moved out of view so now does not. At a certain level of PC / Graphics card power you find that all but the most contrived scenes can be done at a real time rate - and fortunately, so long as we don't squander that power, that's where we are now. :)


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/IconFade1_TN.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/IconFade1.png)

Note the chests in this set of four images as we zoom out. Now the app doesn't just pop too small icons out in a blink. It fades them out so that it looks a little nicer. I should also add that this is with the Child Cut Off set quite high because normally its set to fade out at just a few pixels.

Redrobes
02-09-2010, 07:02 PM
If you want to save a map then we need to be a little clearer about what that means since each icon is like a map in its own right. With ViewingDale you save out the screen image only with a few options. So you need to pan and zoom to the right part of your map first before saving the view. If you have a grid on then you get a grid with the saved image. You get the annotations and jump markers unless you hide them. The only thing you wont get is the main view border, top banner and bottom status bar which are not part of the map.

To get to the save menu item its on the System Settings or F4 and the bottom option. It brings up a dialog panel like this:


http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ScreenSave1.png (http://www.viewing.ltd.uk/Temp/CG/VDTutorial/ScreenSave1.png)

Initially it will have the dots per inch set to your real monitors current DPI rating. The scale will be as you had it at the point of hitting the button. Now with these two values and the current window size, all the rest of the numbers are derived. You can change any of the numbers from here and the related ones will change to match the right math. I.e. you can change DPI to 300 and the width and height in pixels will adjust.

Say you have a 300 DPI printer and want to print a battle map for real miniatures. Then put 300 in the DPI and 60 in the scale (1 in = 5ft ). The rest will adjust and you had better hope your map is small enough to fit on the paper. If you had an A4 300 DPI printer and dont care what the scale comes out at so long as it fits then put 300 in DPI and either 11 in Width or Height depending on whether you want landscape or portrait.

Style is one of two options. As seen on screen or the Color / Alpha pair. The first is what you would expect. The map rendered out to a bit map. The second option saves two bitmaps, one with full color and the second is a greyscale of the combined Alpha / Transparency masking for the whole scene. Ask me if you want to see this or know more.

You set the path or filename and then the format which should be either BMP, JPG or PNG.

It also displays an estimate of the file size tho its pretty rough because its highly dependent on the compression in the PNG / JPG cases tho it should be accurate for BMP.

When it saves the scene it re-renders the whole scene again at the scaling required to get the right output bitmap size. Therefore it does not merely scale the current screen image up or down to fit. So if rendering much larger then detail will be saved not seen on the screen. The grid and the child cut off apply to the save process scaling so that items which were faded out might not be on the save. Same with grid. If the grid was too small to be seen then it might appear on the save if the save image is higher res.

The app has been tested to save at up to 20,000 pixels square in BMP mode. Its a bit less for PNG - something like 14,000 square. The process for the BMP save has been particularly optimized for using a small amount of memory whilst it does it but if saving huge images, it still helps to have a lot of RAM.

Redrobes
02-09-2010, 07:04 PM
That covers most of the things you need to know to use it - well at least from a mapping point of view. Theres a whole heap like that on the VTT and networking side as well. The tut was a bit light on nice maps to show but I have focused more on the concepts. If you want to ask questions then fire them off below and ill write more on that area.

If you did want to see more maps rendered out of the app showing the CWBP (as it was quite a long time ago) then this thread (http://www.cartographersguild.com/showthread.php?t=2182) has a few movies to watch.

industrygothica
02-14-2010, 08:17 AM
I received my copy of ViewingDale in the mail early last week. I think it's the first time I've received post from outside the US, so that was a bit unique in its own right.

I must say that I was more than impressed with the packaging. I'm not sure what my expectations were, but they were surely surpassed as soon as I opened the box. The installation was a breeze as well.

I'll admit, I'm looking at this utility more for the campaign organizer features than anything else. The first thing I wanted to do was to load my world map up and place Romeda in it's proper location, and then start adding notes here and there, and possibly map a city or two to go along with it. I'll be starting a new campaign in the region fairly soon, so this seems like a perfect way to keep everything nice and tidy.

For some reason, however, I can't get the rectangular worldmap to scale properly; it always wants to come up a distorted square. Redrobes, do you think you could break it down to a kindergarten level for me so I could get it put together properly?

Thank tons!


-IG

Redrobes
02-14-2010, 09:16 AM
I must say that I was more than impressed with the packaging.Thats cool. The box artwork apart from the 3D cover image, insert and card is all done with the app. The whole print industry is totally geared up for Adobe products so I had some problems getting compatible artwork to them.


I'm looking at this utility more for the campaign organizer features than anything else.Thats its prime directive. Its a VTT second to its world organization aims.


For some reason, however, I can't get the rectangular worldmap to scale properly; it always wants to come up a distorted square. Redrobes, do you think you could break it down to a kindergarten level for me so I could get it put together properly?Sure.

Theres two stages, getting the image in and making an icon for it.

Image:
In a paint package make a bitmap of the world at a max res of about 2048. Dont worry about the aspect or scaling - thats all part of the icon params. The bitmap can be square or oblong. Lets say its the usual 2:1 aspect and 2048x1024 image. If its a really big image then theres another way but lets ignore that for a while.

In the App, press F2 for "Images and Icons" and the top item is Convert (Import) Image. Hit that button. With the three black paneled dialog up hit the "Load Colour Picture" and browse for your image (BMP, JPG, PNG or some TIF) anywhere on the HDD. Once loaded it should be in the color panel and the Final Image Panel. If the final image looks ok then hit the "Save final image" button and save it into a sensible directory under the ViewingDale/Images directory. The App wont let you go higher than this directory anyway. Try something like Fantasy/Worlds/Romeda or something like that. You can create new sub directories with the top item (Add new directory). Keep a mental note where it is. Theres no scaling or anything to do - thats it. If you browse with windows explorer then the file should be there with a .vmi extension.

Hit F2 again and in the Images and Icons menu hit the "Create New Icon from Image Wizard". It has a few params to fill out and you need to set them all except the Default Origin which is set at Center unless you change that to Bottom Left - which with a world icon is probably a good idea. You can change any or all of these later anyway.

Set the Icon Name - Romeda. Set the directory for it. This is the Icon dir now. So make another set of sub directories like Fantasy / Worlds / Romeda. With "Using Image", browse for the image you created in Images/Fantasy/Worlds/Romeda. Now set the "Width" to be something like "4000 miles" and the "Height" to be "2000 miles" - unfortunately, ViewingDale does not work in curved spaces so does not cope with different map projections. If thats a real problem then you can use jump points for large areas like continents and jump down to smaller maps where the curvature is so small it can be approximated. But ignoring this, once you have all the top 5 params set and the origin either center or bottom left then hit the "Create it" button and it will make the icon that size.

If you hit F3 for the visual settings and press "Grid Size" and set it to "500 miles" and then press 'G' key then the square grid should show you the world has 8 x 4 grid squares. The title bar should show you the scale which would be a big number and you can pan around and see the position update in miles.


Ok, lets say you have your icon and image and its the wrong size or aspect. Load it with 'L' key so its on the screen then press F8 to go to the "Icon Size" view mode. From here you can scale, size and change the aspect of it. You press the arrow keys where right and up is bigger and left and down is smaller. You will see it stretch a bit. Now in the top bar there is the background grid scale which changes dynamically depending on the current icon size. The units are the same as the map grid units so might be in miles now.

When you press the right key it grows at a modest pace. If you press shift key as well then it goes fast (ctrl makes it go slow. Shift + Ctrl is very slow). You can press right and up at the same time and add shift or ctrl as well all at the same time. Keep looking at the background scale and count up the squares its covering. Imagine that the icon is a bit of stretchy paper on a graph paper backdrop. Sometimes you will have to stretch it a lot especially if the map started at 1mx1m. If it stretches right off the page - which is quite common if scaling a lot - or it stretches too small to see well then hit the "Home" button which will snap view to fit.

LonewandererD
02-17-2010, 05:33 AM
I gotta looked at this in detail later. I must say I cracked up laughing when I saw the option "Edit Children", don't all parents wish they could have that.

-D-