API for Snapping - supporting addons for architecture

Architecture is a area that could be further explored in the addons. However the lack of exposed snapping functions in python, limits (significantly) the creation of addons for this purpose.

Therefore, I propose the creation of a snap method to the class "Object". So we would have something like ...:

Object.snap_ray_to_geometry(origin, direction, dist, snap_vert, snap_edge, snap_face, use_depth, virtual_cone)

• origin -> Vector;
• direction -> Vector;
• dist -> minimum distance to snap between the element and the ray;
• snap_vert, snap_edge, snap_face -> bools indicating which elements are used for snapping;
• use_depth -> ignore what is hidden behind the face.
• virtual_cone -> bool. The minimum distance is multiplied by depth (useful for perspective view)

This function would return the coordinated, the index and the type of the element that received the snapping (Vertex, Edge or Face).