packer3d 0.5.0__py3-none-win_amd64.whl

packer3d-0.5.0.data/purelib/packer3d/__init__.py

@@ -0,0 +1,10 @@
+"""paCker cuboid packing for Python: the native engine ships inside the wheel.
+
+    from packer3d import Packer
+    result = (Packer().add_box(id='carton', width=180, length=180, height=30)
+              .add_item(id='bar', width=220, length=30, height=20, quantity=3).pack())
+"""
+from packer_adapter.client import Packer, PackerError, default_binary
+
+__version__ = '0.5.0'
+__all__ = ['Packer', 'PackerError', 'default_binary', '__version__']

packer3d-0.5.0.data/purelib/packer3d/bin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 paCker contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packer3d-0.5.0.data/purelib/packer3d/bin/LICENSE-cJSON

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2017 Dave Gamble and cJSON contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

packer3d-0.5.0.data/purelib/packer_adapter/__init__.py

@@ -0,0 +1,4 @@
+"""paCker Python facade, independent result validation and image rendering."""
+from .client import Packer, PackerError
+
+__all__ = ["Packer", "PackerError"]

packer3d-0.5.0.data/purelib/packer_adapter/assets/camera.js

@@ -0,0 +1,23 @@
+// Fit world bounds in the camera's projected horizontal and vertical extents.
+export function fitPackingCamera(THREE, camera, bounds, direction, margin=.9) {
+  const center=bounds.getCenter(new THREE.Vector3());
+  const size=bounds.getSize(new THREE.Vector3());
+  const extent=Math.max(size.x,size.y,size.z,1e-6);
+  const eye=direction.lengthSq() ? direction.clone().normalize() : new THREE.Vector3(.8,-1,.78).normalize();
+  const right=new THREE.Vector3().crossVectors(camera.up,eye).normalize();
+  const up=new THREE.Vector3().crossVectors(eye,right).normalize();
+  const tanY=Math.tan(THREE.MathUtils.degToRad(camera.fov/2))*margin;
+  const tanX=tanY*camera.aspect;
+  let distance=extent*.01;
+  for (const x of [bounds.min.x,bounds.max.x]) for (const y of [bounds.min.y,bounds.max.y]) for (const z of [bounds.min.z,bounds.max.z]) {
+    const p=new THREE.Vector3(x,y,z).sub(center);
+    distance=Math.max(distance,p.dot(eye)+Math.abs(p.dot(right))/tanX,p.dot(eye)+Math.abs(p.dot(up))/tanY);
+  }
+  camera.position.copy(center).addScaledVector(eye,distance);
+  camera.near=Math.max(1e-10,distance/10000);
+  camera.far=distance+extent*10;
+  camera.lookAt(center);
+  camera.updateProjectionMatrix();
+  camera.updateMatrixWorld(true);
+  return {center,extent,distance};
+}

packer3d-0.5.0.data/purelib/packer_adapter/assets/packing-scene.js

@@ -0,0 +1,94 @@
+import {itemPose, normalizedQuaternion} from './pose.js';
+
+export const COLORS = [0x36a58a, 0xe4ad58, 0x709dcc, 0xa591cf, 0xdc887f, 0x84ad65];
+
+// Inspection only: expand centers uniformly, leaving every solid's shape intact.
+// Uniform expansion preserves a separating plane between disjoint convex solids.
+export function inspectionCenter(center, bin, amount) {
+  if (!amount) return [...center];
+  return center.map((value,axis) => {
+    const origin=[bin.width,bin.length,bin.height][axis]/2;
+    return origin+(value-origin)*(1+2.5*amount);
+  });
+}
+
+function numberLabel(THREE, number, size) {
+  const canvas=document.createElement('canvas');canvas.width=128;canvas.height=128;
+  const context=canvas.getContext('2d');
+  context.fillStyle='#ffffff';context.beginPath();context.arc(64,64,53,0,Math.PI*2);context.fill();
+  context.strokeStyle='#184c41';context.lineWidth=8;context.stroke();
+  context.fillStyle='#173b34';context.font='bold 60px system-ui, sans-serif';
+  context.textAlign='center';context.textBaseline='middle';context.fillText(String(number),64,68);
+  const texture=new THREE.CanvasTexture(canvas);
+  const sprite=new THREE.Sprite(new THREE.SpriteMaterial({map:texture,transparent:true,depthTest:false}));
+  sprite.scale.set(size,size,1);sprite.renderOrder=10;sprite.userData.number=number;
+  return sprite;
+}
+
+export function createItemMesh(THREE, pose, color) {
+  const mesh = new THREE.Mesh(
+    new THREE.BoxGeometry(pose.width, pose.length, pose.height),
+    new THREE.MeshStandardMaterial({color, roughness: .55, metalness: .02})
+  );
+  mesh.position.fromArray(pose.center);
+  mesh.quaternion.fromArray(normalizedQuaternion(pose.orientation));
+  const edge = new THREE.LineSegments(
+    new THREE.EdgesGeometry(mesh.geometry),
+    new THREE.LineBasicMaterial({color: 0x173a34, transparent: true, opacity: .42})
+  );
+  mesh.add(edge);
+  return mesh;
+}
+
+export function buildPackingScene(THREE, result) {
+  const root = new THREE.Group();
+  const boxes = [];
+  const items = [];
+  const schema = result.schema_version || 1;
+  const widest = Math.max(1, ...result.bins.map(b => Math.max(b.width, b.length, b.height)));
+  const maxWidth = Math.max(1, ...result.bins.map(b => b.width));
+  const maxLength = Math.max(1, ...result.bins.map(b => b.length));
+  const columns = Math.max(1,Math.ceil(Math.sqrt(result.bins.length * 1.6)));
+  result.bins.forEach((bin, boxIndex) => {
+    const group = new THREE.Group();
+    // Container origin is its lower, left, near corner. Keep every item pose intact.
+    const offset=[(boxIndex%columns)*(maxWidth+widest*.35),Math.floor(boxIndex/columns)*(maxLength+widest*.35)];
+    group.position.set(offset[0],offset[1],0);
+    const geometry = new THREE.BoxGeometry(bin.width, bin.length, bin.height);
+    const shell = new THREE.Mesh(geometry, new THREE.MeshPhysicalMaterial({
+      color: 0xb4cad4, transparent: true, opacity: .085, depthWrite: false,
+      side: THREE.DoubleSide, roughness: .85
+    }));
+    shell.position.set(bin.width / 2, bin.length / 2, bin.height / 2);
+    group.add(shell);
+    const edges = new THREE.LineSegments(new THREE.EdgesGeometry(geometry),
+      new THREE.LineBasicMaterial({color: 0x5c7883, transparent: true, opacity: .7}));
+    edges.position.copy(shell.position);
+    group.add(edges);
+    const floor = new THREE.Mesh(new THREE.PlaneGeometry(bin.width, bin.length),
+      new THREE.MeshStandardMaterial({color: 0xe0e8ec, side: THREE.DoubleSide, roughness: 1}));
+    floor.position.set(bin.width / 2, bin.length / 2, -.001 * widest);
+    group.add(floor);
+    bin.items.forEach((item, itemIndex) => {
+      const pose = itemPose(item, schema);
+      const mesh = createItemMesh(THREE, pose, COLORS[items.length % COLORS.length]);
+      mesh.userData = {boxIndex, itemIndex, base: mesh.position.clone(), pose};
+      group.add(mesh);
+      const label=numberLabel(THREE, items.length+1, Math.max(2.5,Math.min(14,widest*.13)));
+      label.position.copy(mesh.position);label.position.z+=Math.max(item.height*.15,widest*.025);
+      group.add(label);
+      items.push({mesh, label, pose, item, boxIndex, itemIndex, color: COLORS[items.length % COLORS.length]});
+    });
+    root.add(group);
+    boxes.push({group, bin, offset});
+  });
+  return {root, boxes, items};
+}
+
+export function disposePackingScene(scene) {
+  scene?.root.traverse(object => {
+    object.geometry?.dispose();
+    if (Array.isArray(object.material)) object.material.forEach(material => material.dispose());
+    else {object.material?.map?.dispose();object.material?.dispose();}
+  });
+}

packer3d-0.5.0.data/purelib/packer_adapter/assets/pose.js

@@ -0,0 +1,21 @@
+// Solver coordinates are right-handed, Z up. All mesh positions are centers.
+export function itemPose(item, schemaVersion = 1) {
+  if (schemaVersion === 2) {
+    return {
+      width: item.width, length: item.length, height: item.height,
+      center: [...item.center], orientation: [...item.orientation]
+    };
+  }
+  const half = item.angle * Math.PI / 360;
+  return {
+    width: item.width, length: item.length, height: item.height,
+    center: [item.x, item.y, item.z + item.height / 2],
+    orientation: [0, 0, Math.sin(half), Math.cos(half)]
+  };
+}
+
+export function normalizedQuaternion(q) {
+  const norm = Math.hypot(...q);
+  if (!Number.isFinite(norm) || norm === 0) throw new Error('Invalid product orientation.');
+  return q.map(component => component / norm);
+}

packer3d-0.5.0.data/purelib/packer_adapter/assets/render.html

@@ -0,0 +1,63 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=1024,height=768,initial-scale=1">
+  <title>paCker final packing image</title>
+  <script type="importmap">{"imports":{"three":"./vendor/three.module.js"}}</script>
+  <style>
+    html,body{margin:0;width:1024px;height:768px;overflow:hidden;background:#f3f7f6;color:#173b34;font:16px system-ui,sans-serif}
+    #scene{position:absolute;inset:0}
+    #caption{position:absolute;left:28px;top:24px;padding:12px 16px;background:#ffffffed;border:1px solid #b9c9c3;border-radius:8px;max-width:900px}
+    #caption strong{display:block;font-size:20px}
+    #caption span{font-size:13px;color:#49645c}
+  </style>
+</head>
+<body>
+  <div id="scene"></div><div id="caption"></div>
+  <script type="module">
+    import * as THREE from 'three';
+    import {buildPackingScene,disposePackingScene} from './packing-scene.js';
+    import {fitPackingCamera} from './camera.js';
+    const scene=new THREE.Scene();scene.background=new THREE.Color(0xf3f7f6);
+    scene.add(new THREE.HemisphereLight(0xffffff,0x7b8c98,2.5));
+    const light=new THREE.DirectionalLight(0xffffff,3);light.position.set(150,-250,450);scene.add(light);
+    const camera=new THREE.PerspectiveCamera(38,1024/768,.01,1e9);camera.up.set(0,0,1);
+    const renderer=new THREE.WebGLRenderer({antialias:true,preserveDrawingBuffer:true});
+    renderer.setPixelRatio(1);renderer.setSize(1024,768,false);renderer.outputColorSpace=THREE.SRGBColorSpace;
+    document.querySelector('#scene').appendChild(renderer.domElement);
+    let packing=null;
+    window.sceneReady=false;
+    window.renderScene=async ({result,boxIndex,view}) => {
+      window.sceneReady=false;
+      if (!['isometric','top'].includes(view) || !Number.isInteger(boxIndex) || boxIndex<0 || boxIndex>=result.bins.length)
+        throw Error('Invalid box or view');
+      if (packing){scene.remove(packing.root);disposePackingScene(packing);}
+      packing=buildPackingScene(THREE,result);
+      scene.add(packing.root);
+      packing.boxes.forEach(({group},i)=>group.visible=i===boxIndex);
+      const target=packing.boxes[boxIndex].group;
+      const bounds=new THREE.Box3().setFromObject(target);
+      fitPackingCamera(THREE,camera,bounds,view==='top' ? new THREE.Vector3(0,-.001,1) : new THREE.Vector3(.8,-1,.78),.78);
+      const bin=result.bins[boxIndex];
+      const caption=document.querySelector('#caption');caption.replaceChildren();
+      const title=document.createElement('strong');title.textContent=`Box ${boxIndex+1} · ${bin.type_id}`;
+      const detail=document.createElement('span');detail.textContent=`${bin.width} × ${bin.length} × ${bin.height} · ${bin.items.length} product${bin.items.length===1?'':'s'} · ${view==='top'?'Top':'Isometric'} view`;
+      caption.append(title,detail);
+      renderer.render(scene,camera);
+      await new Promise(resolve=>requestAnimationFrame(()=>{renderer.render(scene,camera);resolve();}));
+      window.sceneReady=true;
+      return {boxIndex,view,camera:camera.position.toArray(),items:packing.items.filter(x=>x.boxIndex===boxIndex).map(x=>({
+        id:x.item.id,instance:x.item.instance,center:x.pose.center,meshCenter:x.mesh.position.toArray(),
+        orientation:x.pose.orientation,
+        width:x.pose.width,length:x.pose.length,height:x.pose.height
+      }))};
+    };
+    window.capturePng=()=>{
+      if (!window.sceneReady) throw Error('Scene is not ready');
+      return renderer.domElement.toDataURL('image/png');
+    };
+    window.renderPageReady=true;
+  </script>
+</body>
+</html>

packer3d-0.5.0.data/purelib/packer_adapter/assets/vendor/LICENSE-three.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright © 2010-2025 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.