gojs

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no, viewport-fit=cover"/> <link rel="stylesheet" href="../assets/css/style.css"/>  <title> GoJS Pictures -- Northwoods Software </title> <link rel="stylesheet" href="../assets/css/prism.css" /> </head> <script> window.diagrams = []; window.goCode = function(pre, w, h, parentid, animation) { window.diagrams.push([pre, w, h, parentid, animation]); } </script> <body> <nav id="navTop" class="w-full z-30 top-0 text-white bg-nwoods-primary"> <div class="w-full container max-w-screen-lg mx-auto flex flex-wrap sm:flex-nowrap items-center justify-between mt-0 py-2"> <div class="md:pl-4"> <a class="text-white hover:text-white no-underline hover:no-underline font-bold text-2xl lg:text-4xl rounded-lg hover:bg-nwoods-secondary " href="../"> <h1 class="my-0 p-1 ">GoJS</h1> </a> </div> <button id="topnavButton" class="rounded-lg sm:hidden focus:outline-none focus:ring" aria-label="Navigation"> <svg fill="currentColor" viewBox="0 0 20 20" class="w-6 h-6"> <path id="topnavOpen" fill-rule="evenodd" d="M3 5a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM3 10a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM9 15a1 1 0 011-1h6a1 1 0 110 2h-6a1 1 0 01-1-1z" clip-rule="evenodd"></path> <path id="topnavClosed" class="hidden" fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path> </svg> </button> <div id="topnavList" class="hidden sm:block items-center w-auto mt-0 text-white p-0 z-20"> <ul class="list-reset list-none font-semibold flex justify-end flex-wrap sm:flex-nowrap items-center px-0 pb-0"> <li class="p-1 sm:p-0"><a class="topnav-link" href="../learn/">Learn</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="../samples/">Samples</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="../intro/">Intro</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="../api/">API</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="https://www.nwoods.com/products/register.html">Register</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="../download.html">Download</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="https://forum.nwoods.com/c/gojs/11">Forum</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="https://www.nwoods.com/contact.html" target="_blank" rel="noopener" onclick="getOutboundLink('https://www.nwoods.com/contact.html', 'contact');">Contact</a></li> <li class="p-1 sm:p-0"><a class="topnav-link" href="https://www.nwoods.com/sales/index.html" target="_blank" rel="noopener" onclick="getOutboundLink('https://www.nwoods.com/sales/index.html', 'buy');">Buy</a></li> </ul> </div> </div> <hr class="border-b border-gray-600 opacity-50 my-0 py-0" /> </nav> <div class="md:flex flex-col md:flex-row md:min-h-screen w-full max-w-screen-xl mx-auto"> <div id="navSide" class="flex flex-col w-full md:w-40 lg:w-48 text-gray-700 bg-white flex-shrink-0"> <div class="flex-shrink-0 px-8 py-4"> <button id="navButton" class="rounded-lg md:hidden focus:outline-none focus:ring" aria-label="Navigation"> <svg fill="currentColor" viewBox="0 0 20 20" class="w-6 h-6"> <path id="navOpen" fill-rule="evenodd" d="M3 5a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM3 10a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM9 15a1 1 0 011-1h6a1 1 0 110 2h-6a1 1 0 01-1-1z" clip-rule="evenodd"></path> <path id="navClosed" class="hidden" fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path> </svg> </button> </div> <nav id="navList" class="min-h-screen hidden md:block sidebar-nav flex-grow px-1 lg:px-4 pb-4 md:pb-0 md:overflow-y-auto break-words"> <a href="index.html">Basics</a> <a href="buildingObjects.html">Building Parts</a> <a href="usingModels.html">Using Models</a> <a href="dataBinding.html">Data Binding</a> <a href="react.html">GoJS with React</a> <a href="angular.html">GoJS with Angular</a> <a href="textBlocks.html">TextBlocks</a> <a href="shapes.html">Shapes</a> <a href="pictures.html">Pictures</a> <a href="panels.html">Panels</a> <a href="tablePanels.html">Table Panels</a> <a href="brush.html">Brushes</a> <a href="sizing.html">Sizing Objects</a> <a href="itemArrays.html">Item Arrays</a> <a href="changedEvents.html">Changed Events</a> <a href="transactions.html">Transactions</a> <a href="viewport.html">Coordinates</a> <a href="initialView.html">Initial View</a> <a href="collections.html">Collections</a> <a href="links.html">Links</a> <a href="linkLabels.html">Link Labels</a> <a href="connectionPoints.html">Link Points</a> <a href="ports.html">Ports</a> <a href="nodes.html">Nodes</a> <a href="typings.html">Typings</a> <a href="debugging.html">Debugging</a> <a href="layouts.html">Layouts</a> <a href="trees.html">Trees</a> <a href="subtrees.html">SubTrees</a> <a href="groups.html">Groups</a> <a href="subgraphs.html">SubGraphs</a> <a href="sizedGroups.html">Sized Groups</a> <a href="selection.html">Selection</a> <a href="highlighting.html">Highlighting</a> <a href="animation.html">Animation</a> <a href="toolTips.html">ToolTips</a> <a href="contextmenus.html">Context Menus</a> <a href="events.html">Diagram Events</a> <a href="tools.html">Tools</a> <a href="commands.html">Commands</a> <a href="permissions.html">Permissions</a> <a href="validation.html">Validation</a> <a href="HTMLInteraction.html">HTML Interaction</a> <a href="layers.html">Layers & Z-ordering</a> <a href="palette.html">Palette</a> <a href="overview.html">Overview</a> <a href="resizing.html">Resizing Diagrams</a> <a href="replacingDeleting.html">Replacing and Deleting</a> <a href="buttons.html">Buttons</a> <a href="templateMaps.html">Template Maps</a> <a href="legends.html">Legends and Titles</a> <a href="extensions.html">Extensions</a> <a href="geometry.html">Geometry Strings</a> <a href="grids.html">Grid Patterns</a> <a href="graduatedPanels.html">Graduated Panels</a> <a href="makingImages.html">Diagram Images</a> <a href="makingSVG.html">Diagram SVG</a> <a href="printing.html">Printing</a> <a href="serverSideImages.html">Server-side Images</a> <a href="nodeScript.html">GoJS in Node.js</a> <a href="testing.html">Testing</a> <a href="storage.html">Storage</a> <a href="performance.html">Performance</a> <a href="source.html">Building from Source</a> <a href="platforms.html">Platforms</a> <a href="deployment.html">Deployment</a> </nav> </div> <div class="pt-4 px-2 md:px-0 lg:px-4 pb-16 w-full overflow-hidden"> <h1>Pictures</h1> <p> Use the <a>Picture</a> class to display images. The most common usage is to set the <a>Picture.source</a> property with a URL string, along with the <a>GraphObject.desiredSize</a> or the <a>GraphObject.width</a> and <a>GraphObject.height</a>. </p> <p> If the URL is just a simple constant string, you can pass the string directly as an argument to <a>GraphObject,make</a>, rather than assign the "source:" property. Both techniques have the same effect. </p> <p> In these simplistic demonstrations, the code programmatically creates a Part and adds it to the Diagram. Once you learn about models and data binding you will generally not create parts (nodes or links) programmatically. </p> <pre class="lang-js" id="source"><code> diagram.add( $(go.Part, $(go.Picture, "images/100x65.png") )); </code></pre> <script>goCode("source", 600, 160)</script> <p> However for more sophisticated control you can set the <a>Picture.element</a> to an <b>HTMLImageElement</b> or an <b>HTMLCanvasElement</b>. </p> <h3 id="SimpleIconsUsingFonts">Simple Icons Using Fonts</h3> <p> Note: for showing simple icons you may want to use an icon font. See the example using a <a>TextBlock</a> rather than a <a>Picture</a> at: <a href="textBlocks.html#IconFonts">Icon Fonts</a> </p> <h2 id="Sizing">Sizing</h2> <p> If you do not set the <a>GraphObject.desiredSize</a> of a <a>Picture</a>, it will get the picture's natural size. But when you set the desiredSize to be something different than the natural size, the picture may be stretched or compressed to fit. </p> <p> The following pictures all show a picture of kittens that is 100x65 pixels. </p> <ul> <li>The first picture shows the image at its natural size.</li> <li>The second picture also shows the image at its natural size, but has its desiredSize set explicitly.</li> <li>The third picture increases the size of the Picture, causing the image to be expanded evenly.</li> <li>The fourth picture squeezes the 100x65 image into a 50x32.5 space -- half size. This also maintains the original aspect ratio of the image.</li> <li>The last picture sets the picture size to be 50x70, which changes the aspect ratio to be taller and thinner than the original.</li> </ul> <pre class="lang-js" id="sizedPictures"><code> diagram.add( $(go.Part, "Table", $(go.Picture, { source: "images/100x65.png", column: 0, margin: 2 }), $(go.TextBlock, "natural", { row: 1, column: 0 }), $(go.Picture, { source: "images/100x65.png", column: 1, width: 100, height: 65, margin: 2 }), $(go.TextBlock, "same size", { row: 1, column: 1 }), $(go.Picture, { source: "images/100x65.png", column: 2, width: 200, height: 130, margin: 2 }), $(go.TextBlock, "bigger", { row: 1, column: 2 }), $(go.Picture, { source: "images/100x65.png", column: 3, width: 50, height: 32.5, margin: 2 }), $(go.TextBlock, "smaller", { row: 1, column: 3 }), $(go.Picture, { source: "images/100x65.png", column: 4, width: 50, height: 70, margin: 2 }), $(go.TextBlock, "stretched", { row: 1, column: 4 }) )); </code></pre> <script>goCode("sizedPictures", 600, 160)</script> <p> Note that it may take a while for the media to load. Until the time that the media has loaded sufficiently to know its natural size, the Picture may have the wrong size, such as 0x0. We recommend that you specify the desiredSize (or width and height) so that the Panel(s) holding the Picture will not have to rearrange themselves once the media has loaded. </p> <p> However for the times when you cannot know the natural size ahead of time, there are alternative ways of stretching images to fit in a given space. </p> <h2 id="ImageStretch">Image Stretch</h2> <p> Instead of always stretching or compressing to fill the desiredSize, you can set the <a>Picture.imageStretch</a> property to control the size and aspect ratio of the drawn image. </p> <p> The following pictures demonstrate the four possible values for Picture.imageStretch. All four Pictures here have the size 60x80 and show the same 100x65 PNG file. The Pictures also have a light green background, to show the space available that may be left unused, but is still part of the Picture's bounds. </p> <ul> <li>The first picture demonstrates the default behavior, to stretch in both directions. Note how the image is distorted to be narrower than it should be. However, all of the image is shown. Because the image fills the whole area and the image is not translucent, the background color does not show anywhere. </li> <li>You can see in the second picture, using an imageStretch of <a>GraphObject,None</a>, how it only shows a fraction of the whole kitten image. Because the desiredSize is smaller than the natural size of the image, parts of the image are clipped. </li> <li>The third picture shows how a <a>GraphObject,Uniform</a> imageStretch will make sure that all of the image is shown, at the expense of reducing the scale and leaving some empty space at the sides or at the top and bottom. In this case, because the natural image aspect ratio is wider than the available 60x80 aspect ratio, the empty space will be at the top and bottom. </li> <li>The fourth picture shows how a <a>GraphObject,UniformToFill</a> imageStretch will ensure that the whole area is occupied with image, but that not all of the image is shown, since some may be clipped at the sides or at the top and bottom. Such images normally have a larger scale than when using Uniform imageStretch. In this case what must be clipped is at the sides of the image. </li> <li>Finally there is a separate Part containing the original image, sized naturally, for comparison.</li> </ul> <pre class="lang-js" id="stretchedPictures"><code> diagram.add( $(go.Part, "Table", $(go.Picture, "images/100x65.png", { column: 0, width: 60, height: 80, margin: 2, background: "chartreuse", imageStretch: go.GraphObject.Fill }), $(go.TextBlock, "Fill", { row: 1, column: 0 }), $(go.Picture, "images/100x65.png", { column: 1, width: 60, height: 80, margin: 2, background: "chartreuse", imageStretch: go.GraphObject.None }), $(go.TextBlock, "None", { row: 1, column: 1 }), $(go.Picture, "images/100x65.png", { column: 2, width: 60, height: 80, margin: 2, background: "chartreuse", imageStretch: go.GraphObject.Uniform }), $(go.TextBlock, "Uniform", { row: 1, column: 2 }), $(go.Picture, "images/100x65.png", { column: 3, width: 60, height: 80, margin: 2, background: "chartreuse", imageStretch: go.GraphObject.UniformToFill }), $(go.TextBlock, "UniformToFill", { row: 1, column: 3 }) )); // The original image sized naturally, for comparison diagram.add( $(go.Part, "Vertical", $(go.Picture, "images/100x65.png"), $(go.TextBlock, "Original image,\nsized naturally") )); </code></pre> <script>goCode("stretchedPictures", 600, 120)</script> <p> When images are clipped you can control what part of the image is drawn by using the <a>Picture.imageAlignment</a> property. </p> <h2 id="Clipping">Clipping</h2> <p> If you have a Picture that must be clipped to a geometry, such as to produce a circular image, there are two options. The first is to use a "frame" geometry to hide part of the image. Typically this frame is the same color as the Diagram background or the background of the Node. This method does not change the area of the Picture, does not allow for true transparency, and clicking anywhere in the bounds will always pick the picture. </p> <p> A second method uses <a>Panel.isClipping</a>. This property on a "Spot" Panel allows the filled area of the main Shape to serve as a clipping region instead of a drawn shape. This method does not change the area of the Picture, but does allow for transparency It affects object picking so that only the resultant drawn area is pickable; areas of the image that are not drawn cannot be "hit". </p> <p> Examples of both follow: </p> <pre class="lang-js" id="clipPictures"><code> diagram.layout = $(go.GridLayout); // Using a black "frame" geometry to hide part of the image. // Typically this frame is the same color as the Diagram background or the background of the Node. diagram.add( $(go.Part, "Spot", { scale: 2 }, $(go.Picture, "../samples/images/55x55.png", { width: 55, height: 55, background: 'red' } ), $(go.Shape, { width: 55, height: 55, geometryString: "f M0 0 L100 0 L100 100 L0 100 z M5,50a45,45 0 1,0 90,0a45,45 0 1,0 -90,0 z", fill: 'black', strokeWidth: 0 }) ) ); // Using Panel.isClipping diagram.add( $(go.Part, "Spot", { scale: 2, isClipping: true }, $(go.Shape, "Circle", { width: 55, strokeWidth: 0 } ), $(go.Picture, "../samples/images/55x55.png", { width: 55, height: 55 }) ) ); // Using Panel.isClipping and also having a surrounding border behind it diagram.add( $(go.Part, "Spot", { scale: 2 }, // the background border $(go.Shape, "Circle", { width: 65, strokeWidth: 0, fill: 'red' } ), // the same clipping panel as the second example above $(go.Panel, "Spot", { isClipping: true }, $(go.Shape, "Circle", { width: 55, strokeWidth: 0 } ), $(go.Picture, "../samples/images/55x55.png", { width: 55, height: 55 }) ) ) ); </code></pre> <script>goCode("clipPictures", 500, 200)</script> <h2 id="Flipping">Flipping</h2> <p> You can flip image sources horizontally and vertically with the <a>Picture.flip</a> property: </p> <pre class="lang-js" id="flipPictures"><code> diagram.add( $(go.Part, "Table", $(go.Picture, { source: "images/100x65.png", column: 0, margin: 2, flip: go.GraphObject.None }), $(go.TextBlock, "None (default)", { row: 1, column: 0 }), $(go.Picture, { source: "images/100x65.png", column: 1, margin: 2, flip: go.GraphObject.FlipHorizontal }), $(go.TextBlock, "FlipHorizontal", { row: 1, column: 1 }), $(go.Picture, { source: "images/100x65.png", column: 2, margin: 2, flip: go.GraphObject.FlipVertical }), $(go.TextBlock, "FlipVertical", { row: 1, column: 2 }), $(go.Picture, { source: "images/100x65.png", column: 3, margin: 2, flip: go.GraphObject.FlipBoth }), $(go.TextBlock, "FlipBoth", { row: 1, column: 3 }) )); </code></pre> <script>goCode("flipPictures", 600, 160)</script> <h2 id="CrossOriginPictures">Cross Origin Pictures</h2> <p> Since Pictures are backed by HTMLImageElements, they must abide by the same Cross-origin (CORS) rules that apply to Images. If you are using images that apply to CORS rules, you may need to set the <a>Picture.sourceCrossOrigin</a> property to a function that returns an appropriate value. If <code>sourceCrossOrigin</code> is supplied, the value returned by the function is used as the value of any constructed <code>image.crossOrigin</code>. Example: </p> <pre class="lang-js"><code> $(go.Picture, { width: 64, height: 64 }, { sourceCrossOrigin: pict => "use-credentials" }, new go.Binding("source", "path")) </code></pre> <p> Common values to return are "use-credentials" and "anonymous", but other situations may call for other values or conditional values. We suggest researching <a href="https://enable-cors.org/">cross-origin resource sharing</a> to determine what is right for your situation. </p> <p> If you are using <a>Diagram.makeImage</a>, <a>Diagram.makeImageData</a>, or <a>Diagram.makeSvg</a>, and you are seeing blank or missing images, CORS-related problems are the first thing to investigate. </p> <h2 id="UsingSVGAsPictureSource">Using SVG as a Picture source</h2> <p> Almost all browsers accept SVG files as a Picture source, but in many browsers you <strong>must</strong>: </p> <ul> <li>Assign width and height attributes to the SVG element. These values should be integers. (necessary for Firefox)</li> <li>Assign the Picture element a desired size, which <strong>must</strong> be the same as its width and height attributes (necessary for Internet Explorer).</li> </ul> <p> This first SVG element has a width and height specified in its SVG element, and also has its desired size set. It should display in most browsers: </p> <pre class="lang-html"><code> <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="580" height="580"> ... </code></pre> <pre class="lang-js" id="svg1"><code> diagram.add( $(go.Part, $(go.Picture, { width: 580, height: 580, source: "images/tiger.svg" }) )); diagram.scale = 0.5; </code></pre> <script>goCode("svg1", 300, 300)</script> <p style="color: red;"><strong> This SVG element does not specify width and height attributes in its SVG element, and as a result some browsers may not render it: </strong></p> <pre class="lang-html"><code> <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"> ... </code></pre> <pre class="lang-js" id="svg2"><code> diagram.add( $(go.Part, $(go.Picture, { source: "images/tiger-noWidthHeightSpecified.svg" }) )); diagram.scale = 0.5; </code></pre> <script>goCode("svg2", 300, 300)</script> </div> </div> <div class="bg-nwoods-primary"> <section class="max-w-screen-lg text-white container mx-auto py-2 px-12"> <p id="version" class="leading-none mb-2 my-4">GoJS</p> </section> </div><footer class="bg-nwoods-primary text-white"> <div class="container max-w-screen-lg mx-auto px-8"> <div class="w-full py-6"> <div class="max-w-screen-lg xl:max-w-screen-xl mx-auto px-4 sm:px-6 md:px-8"> <ul class="text-sm font-medium pb-6 grid grid-cols-2 sm:grid-cols-3 gap-y-10"> <li class="list-none row-span-2"> <h2 class="text-base font-semibold tracking-wide">GoJS</h2> <ul class="list-none space-y-4 md:space-y-1 px-0"> <li> <a href="../samples/index.html">Samples</a> </li> <li> <a href="../learn/index.html">Learn</a> </li> <li> <a href="../intro/index.html">Intro</a> </li> <li> <a href="../api/index.html">API</a> </li> <li> <a href="../changelog.html">Changelog</a> </li> <li> <a href="https://github.com/NorthwoodsSoftware/GoJS">GitHub</a> </li> </ul> </li> <li class="list-none row-span-2"> <h2 class="text-base font-semibold tracking-wide">Support</h2> <ul class="list-none space-y-4 md:space-y-1 px-0"> <li> <a href="https://www.nwoods.com/contact.html" target="_blank" rel="noopener" onclick="getOutboundLink('https://www.nwoods.com/contact.html', 'contact');">Contact</a> </li> <li> <a href="https://forum.nwoods.com/c/gojs">Forum</a> </li> <li> <a href="https://www.nwoods.com/app/activate.aspx?sku=gojs">Activate</a> </li> <li> <a href="https://www.nwoods.com/sales/index.html" target="_blank" rel="noopener" onclick="getOutboundLink('https://www.nwoods.com/sales/index.html', 'buy');">Buy</a> </li> <li> <a href="https://www.youtube.com/channel/UC9We8EoX596-6XFjJDtZIDg">Videos</a> </li> </ul> </li> <li class="list-none row-span-2"> <h2 class="text-base font-semibold tracking-wide">Company</h2> <ul class="list-none space-y-4 md:space-y-1 px-0"> <li> <a target="_blank" href="https://www.nwoods.com">Northwoods</a> </li> <li> <a target="_blank" href="https://www.nwoods.com/about.html">About Us</a> </li> <li> <a target="_blank" href="https://www.nwoods.com/contact.html">Contact Us</a> </li> <li> <a target="_blank" href="https://www.nwoods.com/consulting.html">Consulting</a> </li> <li> <a target="_blank" href="https://twitter.com/northwoodsgo">Twitter</a> </li> </ul> </li> </ul> <p class="text-sm text-gray-100 md:mb-6"> Copyright 1998-2023 <a class="text-white" href="https://www.nwoods.com">Northwoods Software</a> </p> </div> </div> </footer> </body> <script async src="https://www.googletagmanager.com/gtag/js?id=G-S5QK8VSK84"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-S5QK8VSK84'); var getOutboundLink = function(url, label) { gtag('event', 'click', { 'event_category': 'outbound', 'event_label': label, 'transport_type': 'beacon' }); } // topnav var topButton = document.getElementById("topnavButton"); var topnavList = document.getElementById("topnavList"); topButton.addEventListener("click", function() { this.classList.toggle("active"); topnavList.classList.toggle("hidden"); document.getElementById("topnavOpen").classList.toggle("hidden"); document.getElementById("topnavClosed").classList.toggle("hidden"); }); </script> <script src="../assets/js/prism.js"></script> <script src="../release/go.js"></script> <script src="../assets/js/goDoc.js"></script> <script> document.addEventListener("DOMContentLoaded", function() { if (window.go) document.getElementById('version').textContent = "GoJS version " + go.version; if (window.goDoc) window.goDoc(); var d = window.diagrams; for (var i = 0; i < d.length; i++) { var dargs = d[i]; goCodeExecute(dargs[0], dargs[1], dargs[2], dargs[3], dargs[4]); } if (window.extra) window.extra(); }); </script> </html>