Program Listing for File acme_aabb.m¶
↰ Return to documentation for file (acme_aabb.m)
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
% %
% The ACME project %
% %
% Copyright (c) 2020, Davide Stocco and Enrico Bertolazzi. %
% %
% The ACME project and its components are supplied under the terms of %
% the open source BSD 2-Clause License. The contents of the ACME %
% project and its components may not be copied or disclosed except in %
% accordance with the terms of the BSD 2-Clause License. %
% %
% URL: https://opensource.org/licenses/BSD-2-Clause %
% %
% Davide Stocco %
% Department of Industrial Engineering %
% University of Trento %
% e-mail: davide.stocco@unitn.it %
% %
% Enrico Bertolazzi %
% Department of Industrial Engineering %
% University of Trento %
% e-mail: enrico.bertolazzi@unitn.it %
% %
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
classdef acme_aabb < acme_entity
%>
%> Class container for ACME disk object
%>
methods
%> Create a new C++ pointer to disk object instance
function this = acme_aabb( varargin )
this.objectHandle = mex_aabb( 'new', varargin{:} );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Create C++ pointer to disk object instance
function delete( this )
mex_aabb( 'delete', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get minimum aabb as ACME point
function out = getMin( this )
out = acme_point();
out.copyByHandle( mex_aabb( 'getMin', this.objectHandle ) );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get aabb minimum point X value
function out = getMinX( this )
out = mex_aabb( 'getMinX', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get aabb minimum point X value
function out = getMinY( this )
out = mex_aabb( 'getMinY', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get aabb minimum point Z value
function out = getMinZ( this )
out = mex_aabb( 'getMinZ', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get maximum aabb as ACME point
function out = getMax( this )
out = acme_point();
out.copyByHandle( mex_aabb( 'getMax', this.objectHandle ) );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get aabb maximum point X value
function out = getMaxX( this )
out = mex_aabb( 'getMaxX', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get aabb maximum point X value
function out = getMaxY( this )
out = mex_aabb( 'getMaxY', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get aabb maximum point Z value
function out = getMaxZ( this )
out = mex_aabb( 'getMaxZ', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set minimum aabb as ACME point
function setMin( this, other_obj )
if (other_obj.type() == "point")
mex_aabb( 'setMin', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::setMin(): other_obj must be an ACME point object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set aabb minimum point X value
function setMinX( this, value )
mex_aabb( 'setMinX', this.objectHandle, value );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set aabb minimum point X value
function setMinY( this, value )
mex_aabb( 'setMinY', this.objectHandle, value );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set aabb minimum point Z value
function setMinZ( this, value )
mex_aabb( 'setMinZ', this.objectHandle, value );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set maximum aabb as ACME point
function setMax( this, other_obj )
if (other_obj.type() == "point")
mex_aabb( 'setMax', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::setMax(): other_obj must be an ACME point object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set aabb maximum point X value
function setMaxX( this, value )
mex_aabb( 'setMaxX', this.objectHandle, value );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set aabb maximum point X value
function setMaxY( this, value )
mex_aabb( 'setMaxY', this.objectHandle, value );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Set aabb maximum point Z value
function setMaxZ( this )
mex_aabb( 'setMaxZ', this.objectHandle, value );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Copy aabb object from another aabb
function copy( this, other_obj )
if (other_obj.type() == "aabb")
mex_aabb( 'copy', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::copy(): other_obj must be an ACME aabb object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Copy aabb object from another aabb handle
function copyByHandle( this, handle )
mex_aabb( 'copy', this.objectHandle, handle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Translate aabb by vector
function translate( this, other_obj )
mex_aabb( 'translate', this.objectHandle, other_obj.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Check if ACME point is inside the aabb
function out = isInside( this, other_obj )
if (other_obj.type() == "point")
out = mex_aabb( 'isInside', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::isInside(): other_obj must be an ACME point object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Check if aabb is degenerated
function out = isDegenerated( this )
out = mex_aabb( 'isDegenerated', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Check if aabbs are approximatively equal
function out = isApprox( this, other_obj )
if (other_obj.type() == "aabb")
out = mex_aabb( 'isApprox', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::isApprox(): other_obj must be an ACME aabb object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Return aabb id
function out = id( this )
out = mex_aabb( 'id', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Return aabb position
function out = pos( this )
out = mex_aabb( 'pos', this.objectHandle );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Perform intersection with another ACME entity and return intersection object
function out = intersection( this, other_obj )
if (other_obj.type() == "aabb")
out = mex_aabb( 'intersection', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::intersection(): other_obj must be an ACME aabb object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Check if aabb intersects with another ACME entity and return boolean
function out = intersects( this, other_obj )
if (other_obj.type() == "aabb")
out = mex_aabb( 'intersects', this.objectHandle, other_obj.objectHandle );
else
error('mex_aabb::intersects(): other_obj must be an ACME aabb object type.');
end
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Display object data
function disp( this )
disp( [ this.getMin().get(), this.getMax().get() ] );
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Plot disk object
function plot( this, figure_name, color )
figure_name;
hold on;
min = this.getMin().get();
max = this.getMax().get();
plot3( [min(1), max(1)], ... % 01
[min(2), min(2)], ...
[min(3), min(3)], ...
'Color', color)
plot3( [min(1), min(1)], ... % 02
[min(2), max(2)], ...
[min(3), min(3)], ...
'Color', color)
plot3( [min(1), min(1)], ... % 03
[min(2), min(2)], ...
[min(3), max(3)], ...
'Color', color)
plot3( [max(1), min(1)], ... % 04
[max(2), max(2)], ...
[max(3), max(3)], ...
'Color', color)
plot3( [max(1), max(1)], ... % 05
[max(2), min(2)], ...
[max(3), max(3)], ...
'Color', color)
plot3( [max(1), max(1)], ... % 06
[max(2), max(2)], ...
[max(3), min(3)], ...
'Color', color)
plot3( [max(1), max(1)], ... % 07
[min(2), max(2)], ...
[min(3), min(3)], ...
'Color', color)
plot3( [min(1), min(1)], ... % 08
[min(2), max(2)], ...
[max(3), max(3)], ...
'Color', color)
plot3( [min(1), max(1)], ... % 09
[min(2), min(2)], ...
[max(3), max(3)], ...
'Color', color)
plot3( [min(1), min(1)], ... % 10
[max(2), max(2)], ...
[min(3), max(3)], ...
'Color', color)
plot3( [max(1), max(1)], ... % 11
[min(2), min(2)], ...
[min(3), max(3)], ...
'Color', color)
plot3( [min(1), max(1)], ... % 12
[max(2), max(2)], ...
[min(3), min(3)], ...
'Color', color)
% Cross lines on faces
plot3( [min(1), max(1)], ... % 13
[min(2), max(2)], ...
[min(3), min(3)], ...
'Color', color)
plot3( [min(1), max(1)], ... % 14
[min(2), max(2)], ...
[max(3), max(3)], ...
'Color', color)
plot3( [min(1), min(1)], ... % 15
[min(2), max(2)], ...
[min(3), max(3)], ...
'Color', color)
plot3( [max(1), max(1)], ... % 16
[min(2), max(2)], ...
[min(3), max(3)], ...
'Color', color)
plot3( [min(1), max(1)], ... % 17
[min(2), min(2)], ...
[min(3), max(3)], ...
'Color', color)
plot3( [min(1), max(1)], ... % 18
[max(2), max(2)], ...
[min(3), max(3)], ...
'Color', color)
hold off;
end
%
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%
%> Get object type as string
function out = type( this )
out = 'aabb';
end
end
end
