kopia lustrzana https://gitlab.com/gerbolyze/gerbonara
127 wiersze
3.2 KiB
Python
127 wiersze
3.2 KiB
Python
#!/usr/bin/env python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# copyright 2015 Hamilton Kibbe <ham@hamiltonkib.be>
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
"""
|
|
CAM File Operations
|
|
===================
|
|
**Transformations and other operations performed on Gerber and Excellon files**
|
|
|
|
"""
|
|
import copy
|
|
|
|
|
|
def to_inch(cam_file):
|
|
""" Convert Gerber or Excellon file units to imperial
|
|
|
|
Parameters
|
|
----------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
Gerber or Excellon file to convert
|
|
|
|
Returns
|
|
-------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
A deep copy of the source file with units converted to imperial.
|
|
"""
|
|
cam_file = copy.deepcopy(cam_file)
|
|
cam_file.to_inch()
|
|
return cam_file
|
|
|
|
|
|
def to_metric(cam_file):
|
|
""" Convert Gerber or Excellon file units to metric
|
|
|
|
Parameters
|
|
----------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
Gerber or Excellon file to convert
|
|
|
|
Returns
|
|
-------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
A deep copy of the source file with units converted to metric.
|
|
"""
|
|
cam_file = copy.deepcopy(cam_file)
|
|
cam_file.to_metric()
|
|
return cam_file
|
|
|
|
|
|
def offset(cam_file, x_offset, y_offset):
|
|
""" Offset a Cam file by a specified amount in the X and Y directions.
|
|
|
|
Parameters
|
|
----------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
Gerber or Excellon file to offset
|
|
|
|
x_offset : float
|
|
Amount to offset the file in the X direction
|
|
|
|
y_offset : float
|
|
Amount to offset the file in the Y direction
|
|
|
|
Returns
|
|
-------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
An offset deep copy of the source file.
|
|
"""
|
|
cam_file = copy.deepcopy(cam_file)
|
|
cam_file.offset(x_offset, y_offset)
|
|
return cam_file
|
|
|
|
|
|
def scale(cam_file, x_scale, y_scale):
|
|
""" Scale a Cam file by a specified amount in the X and Y directions.
|
|
|
|
Parameters
|
|
----------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
Gerber or Excellon file to scale
|
|
|
|
x_scale : float
|
|
X-axis scale factor
|
|
|
|
y_scale : float
|
|
Y-axis scale factor
|
|
|
|
Returns
|
|
-------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
An scaled deep copy of the source file.
|
|
"""
|
|
# TODO
|
|
pass
|
|
|
|
|
|
def rotate(cam_file, angle):
|
|
""" Rotate a Cam file a specified amount about the origin.
|
|
|
|
Parameters
|
|
----------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
Gerber or Excellon file to rotate
|
|
|
|
angle : float
|
|
Angle to rotate the file in degrees.
|
|
|
|
Returns
|
|
-------
|
|
cam_file : :class:`gerber.cam.CamFile` subclass
|
|
An rotated deep copy of the source file.
|
|
"""
|
|
# TODO
|
|
pass
|