Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added a couple more vectormath operations #35

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

Incoherent-Code
Copy link

I added a couple more vector math functions.

  • multiply([vector], [vector]) multiplies 2 vectors together.
  • rotateX([vector], [angle]) rotates the vector around the x axis.
  • rotateY([vector], [angle]) rotates the vector around the y axis.
  • rotateZ([vector], [angle]) rotates the vector around the z axis.

I wrote tests and ran beachball already. Let me know if you have any concerns.

Copy link
Collaborator

@rlandav rlandav left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the contribution! I have added comments suggesting a few changes to be made.

/**
* multiply
*
* Multiplies two vectors together
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you specify here (and the documentation elsewhere for this) that this is a element-wise multiplication? Just want to make sure it's not confused with dot or cross from the intellisense.

* rotateX
*
* Rotates the vector around the x axis
* @param a Angle in radians
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I ran the pipeline for the PR and you have a few lint errors to fix. Specifically, you need params with a dash after the parameter name. If you run npm run lint locally you'll get the full errors to fix (including the need to run prettier which you can do with the --fix option).

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry about that
npm run lint fails on my machine on the prettier stage.
Error: Command failed: C:\Program Files\nodejs\node.exe C:\Users\aiaub\Documents\VSCode\minecraft-scripting-libraries\libraries\math\node_modules\prettier\bin-prettier.js --check src/**/*.ts
I was hoping the vscode extension would catch everything, but I'll try to figure out what's wrong.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you run npm run lint -- -- --fix, it will fix it for you automatically. VSCode should have though 🤷 . Also, the number of extra -- may vary depending on your terminal.

Comment on lines 181 to 189
static rotateX(v: Vector3, a: number): Vector3 {
let cos = Math.cos(a);
let sin = Math.sin(a);
return {
x: v.x,
y: v.y * cos + v.z * sin,
z: v.z * cos - v.y * sin
}
}
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a specific reason that you chose to do the rotation clockwise (i.e. left hand rule) rather than the standard right hand rule?

Preference would be to make all of these helpers adhere to the standard rotation matrix using right hand rule (counter clockwise rotation), i.e. for a 1/2 radian rotation of the unitY vector, it would become a positive unitZ vector for a X rotation rather than a negative unitZ vector

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did it clockwise because the minecraft java function under the same name (yarn mappings) that I was familiar with also rotates clockwise. idk why they did it that way. I can make it counterclockwise if that's more standard.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe there is a bit of history there, but since this helpers will operate purely in javascript land, my preference is to have the rotations follow the standard right hand rule rotation matrix.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you group the rotation functions into a describe block since they are related? Also, can you add tests operating off unit vectors too, so its clear at a glance the rotation direction?

@Incoherent-Code
Copy link
Author

This last commit should fix all the aforementioned issues

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants