xbraster v1.1b readme.txt
Updated 2010-07-17 by oxage

Project is published on http://xbraster.codeplex.com
Please, feel free to post any idea or comment about this project.

== Intro ==
xbraster is a xaml to raster image converting .NET library, stand-alone application, add-in for Expression Blend 3 and plug-in for Kaxaml 1.0.

== License ==
(content is located in License.txt file and applies to all project files)

== Minimum requirements ==
  • Microsoft Windows XP/Vista/7 or other OS that supports .NET 3.5
  • Microsoft .NET 3.5 or later
  • Optional: Microsoft Expression Blend 3 or Kaxaml 1.0



== How to install ==

=== Stand-alone application ===
Extract files from the archive to a directory.

=== Expression Blend ===
Create a folder named "Addins" in Expression Blend directory and copy plug-in files to that folder.

Example:
If Expression Blend directory is located in "C:\Program Files\Microsoft Expression\Blend 3\" then create "C:\Program Files\Microsoft Expression\Blend 3\Addins\" directory and copy files "Raster.Blend.Addin", "Oxage.Rasterizer.Blend.AddIn.dll" and "Oxage.Rasterizer.Control.dll" into that directory. So the copied "Raster.Blend.Addin" should be located as "C:\Program Files\Microsoft Expression\Blend 3\Addins\Raster.Blend.Addin".

=== Kaxaml ===
Copy "RasterPlugin.dll" to "Plugins" directory from Kaxaml directory. Copy "Oxage.Rasterizer.Control.dll" to Kaxaml root directory.



== How to uninstall ==
Remove key from registry: HKEYCURRENTUSER\Software\Oxage\xbraster

=== Stand-alone application ===
Remove extracted files.

=== Expression Blend ===
Remove copied files from "Addins" folder.

=== Kaxaml ===
Remove files "RasterPlugin.dll" from "Plugins" directory and "Oxage.Rasterizer.Control.dll" from Kaxaml directory.



== How to build source code ==
Unpack source code files to a working directory.

If you are using Visual Studio open xbraster.sln and set starting project to Oxage.Rasterizer.WPF. If the Expression Blend directory is other than "C:\Program Files\Microsoft Expression\Blend 3\" remove references in Oxage.Rasterizer.Blend.Addin project and add them again using the right path.

If you are using msbuild.exe edit make.bat and change MSBUILD variable. Save the .bat file and run it.

Project has been originally created with Visual Studio 2008, .NET 3.5 on Windows Vista.


== How to use it ==

=== Expression Blend ===
When the plug-in is installed open Expression Blend, go to "Window" in menu and check the "Rasterizer" item. A panel named "Rasterizer" appears.

Open a xaml document in Expression Blend. Set properties in Rasterizer panel and click Save. Select a destination path and confirm.

=== Kaxaml ===
Similar to Expression Blend except that plug-in is already loaded on startup.


== Notes ==
All units are in pixels (px).

Settings are saved to registry: HKEYCURRENTUSER\Software\Oxage\xbraster

== Troubleshooting ==
Q: "Rasterizer" item does not appear in "Window" menu.
A: Make sure you have copied all three files in the right directory (folder "Addins" with "s"). Make sure you are using the right version of Expression Blend (see minimum requirements). Restart Expression Blend if plug-in has been installed during the application running time.

Q: Artwork is visible in Expression Blend design window but no preview is available in a Preview panel.
A: Make sure you are working with WPF project. Silverlight has different rendering engine - if you have any idea how to display Silverlight content in preview window, please discuss on the project's website.
Also check if Width and Height are not NaN - should have positive numeric value.

Q: Output image does not look like on preview.
A: This is a beta version and not fully tested. Please, report your problem at the project's website.

Last edited Jul 17, 2010 at 1:52 PM by papnkukn, version 1

Comments

No comments yet.